# Cricsheet Ball-by-Ball Data Scraper (IPL, T20, Tests & More) (`jungle_synthesizer/cricsheet-t20-world-cup-ipl-open-data-scraper`) Actor Download ball-by-ball cricket data from Cricsheet — IPL, T20 World Cup, Tests, The Hundred, WBBL and more. Returns one row per delivery with batter, bowler, runs, extras, wickets, and computed strike-rate / economy-rate columns. Open data, near-zero cost. - **URL**: https://apify.com/jungle\_synthesizer/cricsheet-t20-world-cup-ipl-open-data-scraper.md - **Developed by:** [BowTiedRaccoon](https://apify.com/jungle_synthesizer) (community) - **Categories:** Sports, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Cricsheet Ball-by-Ball Cricket Data Scraper (IPL, T20, Tests & More) Download ball-by-ball delivery data from [Cricsheet](https://cricsheet.org) — the canonical open cricket dataset. Returns one row per delivery across IPL, T20 World Cup, Tests, The Hundred, WBBL, and a dozen other competitions, with computed strike-rate and economy-rate columns included. --- ### Cricsheet Scraper Features - Downloads competition archives directly from Cricsheet — no scraping HTML, no pagination, no headaches - Returns **one row per delivery** with full match context: teams, venue, season, innings, over, ball number - Covers 16 competitions: IPL, Men's T20I, Women's T20I, Tests, ODIs, The Hundred, BBL, WBBL, CPL, PSL, SA20, LPL, and more - Computes **strike rate** and **economy rate** per batter/bowler at each ball — running totals, not career averages - Captures wicket type and dismissed player on dismissal balls - Captures extra type (wides, no-balls, byes, leg-byes) on extra deliveries - `maxItems` cap for fast sampling — 5 balls for a quick test, unlimited for the full archive - No browser, no proxy, no anti-bot. Cricsheet is open data. --- ### What Can You Do With Cricsheet Ball-by-Ball Data? - **Fantasy cricket analysts** — Build ball-by-ball performance models for IPL or T20 World Cup — the dataset has every delivery from every season Cricsheet covers - **Data scientists & ML engineers** — Train batting/bowling prediction models on millions of deliveries with clean, structured features - **Cricket statisticians** — Compute career averages, phase-by-phase economy rates, powerplay strike rates, partnership data — it's all in the delivery rows - **Sports betting researchers** — Build in-match probability models using historical ball sequence data - **Journalists & broadcasters** — Pull match context and scoring patterns for retrospective coverage. The Hundred 2026 and T20 World Cup archives are live. - **Educators** — Use real match data for sports analytics courses without wrangling messy CSV exports --- ### How the Cricsheet Scraper Works 1. You select one or more competition keys (e.g. `["ipl", "t20s"]`) and an optional `maxItems` cap 2. The scraper downloads each competition's zip archive directly from Cricsheet (typically 5–20 MB per competition) 3. Each zip contains one JSON file per match. The scraper reads every match in the archive 4. For each delivery in each innings, it emits one output row — with match metadata, delivery fields, and running cumulative stats for that batter and bowler in that innings --- ### Input ```json { "competitions": ["ipl", "t20s"], "maxItems": 1000 } ```` | Field | Type | Default | Description | |-------|------|---------|-------------| | `competitions` | array | — (required) | List of competition keys to download. See below for all valid keys. | | `maxItems` | integer | 0 (unlimited) | Max delivery rows to return. 0 means no cap — you get the full archive. | **Valid competition keys:** | Key | Competition | |-----|-------------| | `ipl` | Indian Premier League (Men) | | `t20s` | T20 Internationals (Men) | | `it20s` | Informal T20 Internationals (Men) | | `tests` | Test Matches (Men) | | `odis` | One Day Internationals (Men) | | `the_hundred` | The Hundred (Men) | | `wbbl` | Women's Big Bash League | | `bbl` | Big Bash League (Men) | | `cpl` | Caribbean Premier League | | `psl` | Pakistan Super League | | `sa20` | SA20 (Men) | | `wt20s` | T20 Internationals (Women) | | `wtests` | Test Matches (Women) | | `wodis` | ODIs (Women) | | `lpl` | Lanka Premier League | | `sma` | Super Smash (New Zealand) | *** ### Cricsheet Scraper Output Fields ```json { "match_id": "1082591", "competition": "IPL", "season": "2017", "venue": "Rajiv Gandhi International Stadium, Uppal", "city": "Hyderabad", "date": "2017-04-05", "team_1": "Sunrisers Hyderabad", "team_2": "Royal Challengers Bangalore", "winner": "Sunrisers Hyderabad", "innings": 1, "over": 0, "ball": 1, "batter": "DA Warner", "bowler": "TS Mills", "non_striker": "S Dhawan", "runs_off_bat": 0, "extras": 0, "extra_type": "", "wicket_kind": "", "dismissed_player": "", "batter_runs_cumulative": 0, "bowler_balls_bowled": 1, "strike_rate": 0, "economy_rate": 0, "source": "ipl_male_json.zip" } ``` | Field | Type | Description | |-------|------|-------------| | `match_id` | string | Cricsheet match ID (numeric, matches the source JSON filename) | | `competition` | string | Competition name — e.g. "IPL", "T20I (Men)", "Test (Men)" | | `season` | string | Season year or label from the Cricsheet metadata | | `venue` | string | Venue name | | `city` | string | City | | `date` | string | Match date (YYYY-MM-DD) — first date for multi-day matches | | `team_1` | string | First team name | | `team_2` | string | Second team name | | `winner` | string | Winning team name, empty if no result or tied | | `innings` | integer | Innings number (1 or 2) | | `over` | integer | Over number (0-indexed) | | `ball` | integer | Ball number within the over (1-indexed, includes extras) | | `batter` | string | Batter name | | `bowler` | string | Bowler name | | `non_striker` | string | Non-striker name | | `runs_off_bat` | integer | Runs scored off the bat on this delivery | | `extras` | integer | Extra runs on this delivery (wides, no-balls, etc.) | | `extra_type` | string | Type of extra: "wides", "no\_balls", "byes", "legbyes", "penalty", or empty | | `wicket_kind` | string | Dismissal type (caught, bowled, lbw, run out, etc.), empty if no wicket | | `dismissed_player` | string | Name of dismissed player, empty if no wicket | | `batter_runs_cumulative` | integer | Batter's total runs in this innings up to and including this ball | | `bowler_balls_bowled` | integer | Legal balls bowled by this bowler in this innings up to and including this ball | | `strike_rate` | number | Batter strike rate at this point (runs / balls × 100) | | `economy_rate` | number | Bowler economy rate at this point (runs / legal balls × 6) | | `source` | string | Source zip filename — e.g. "ipl\_male\_json.zip" | *** ### FAQ #### How do I scrape IPL ball-by-ball data? The Cricsheet Scraper downloads the full IPL archive with `competitions: ["ipl"]`. The IPL archive covers all seasons Cricsheet has ball-by-ball records for — roughly 2008 onwards. The current archive is around 1,200+ matches. #### How much does the Cricsheet Scraper cost to run? The scraper is priced per delivery record. At the default PPE coefficient, a full IPL archive run (roughly 700,000+ deliveries) costs a few cents. Cricsheet is open data, so there are no proxy or residential IP costs. #### Does the Cricsheet Scraper need a proxy or browser? No. Cricsheet.org is a fully open, publicly accessible dataset with no bot protection. The scraper uses direct HTTP downloads with no browser required. #### What is the `strike_rate` field? It's the batter's running strike rate in this innings at the point of this delivery — not a career figure. Computed as (cumulative runs off bat) / (balls faced) × 100. It updates on every legal delivery. #### Can I get the full T20 World Cup dataset? The `t20s` competition key covers all men's T20 Internationals in the Cricsheet archive, which includes T20 World Cup matches. Use `competitions: ["t20s"]` with no `maxItems` cap to get the full archive. #### Why does Cricsheet have more records than competitors? The Cricsheet Scraper pulls data from Cricsheet directly — a dedicated ball-by-ball cricket data project that has been maintained since 2012. The existing scrapers on Apify have 2–4 users combined; none compute derived statistics inline. *** ### Need More Features? Open a feature request on the [actor page](https://apify.com/jungle_synthesizer/cricsheet-t20-world-cup-ipl-open-data-scraper) — common requests include filtered exports by date range, competition-specific schemas, or batched competition sweeps. ### Why Use the Cricsheet Scraper? - **Derived stats included** — Strike rate and economy rate per batter/bowler are computed inline, not left as an exercise for the analyst - **Multi-competition in one run** — Pass multiple keys and get a unified, normalized dataset across all selected competitions - **Open data, minimal cost** — Cricsheet is a public archive; the only cost is the per-record PPE charge, which is low - **No proxy, no browser, no fragility** — Direct zip downloads from Cricsheet's CDN. Nothing to break when a UI changes. # Actor input Schema ## `sp_intended_usage` (type: `string`): Please describe how you plan to use the data extracted by this crawler. ## `sp_improvement_suggestions` (type: `string`): Provide any feedback or suggestions for improvements. ## `sp_contact` (type: `string`): Provide your email address so we can get in touch with you. ## `competitions` (type: `array`): List of competition keys to download. Options: ipl, t20s, tests, t20\_wc, it20s, odi, wt20s, wtests, wodis, the\_hundred, wbbl, bbl, cpl, psl, sa20, ipl\_w, lpl, sma. Leave empty to download all T20Is + IPL. ## `maxItems` (type: `integer`): Maximum number of delivery records to output (0 = unlimited) ## Actor input object example ```json { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "competitions": [ "ipl", "t20s" ], "maxItems": 10 } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "competitions": [ "ipl", "t20s" ], "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("jungle_synthesizer/cricsheet-t20-world-cup-ipl-open-data-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "competitions": [ "ipl", "t20s", ], "maxItems": 10, } # Run the Actor and wait for it to finish run = client.actor("jungle_synthesizer/cricsheet-t20-world-cup-ipl-open-data-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "competitions": [ "ipl", "t20s" ], "maxItems": 10 }' | apify call jungle_synthesizer/cricsheet-t20-world-cup-ipl-open-data-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=jungle_synthesizer/cricsheet-t20-world-cup-ipl-open-data-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Cricsheet Ball-by-Ball Data Scraper (IPL, T20, Tests & More)", "description": "Download ball-by-ball cricket data from Cricsheet — IPL, T20 World Cup, Tests, The Hundred, WBBL and more. Returns one row per delivery with batter, bowler, runs, extras, wickets, and computed strike-rate / economy-rate columns. Open data, near-zero cost.", "version": "0.1", "x-build-id": "elsYfthODOQxogVuS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~cricsheet-t20-world-cup-ipl-open-data-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-cricsheet-t20-world-cup-ipl-open-data-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/jungle_synthesizer~cricsheet-t20-world-cup-ipl-open-data-scraper/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-cricsheet-t20-world-cup-ipl-open-data-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/jungle_synthesizer~cricsheet-t20-world-cup-ipl-open-data-scraper/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-cricsheet-t20-world-cup-ipl-open-data-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "competitions" ], "properties": { "sp_intended_usage": { "title": "What is the intended usage of this data?", "minLength": 1, "type": "string", "description": "Please describe how you plan to use the data extracted by this crawler." }, "sp_improvement_suggestions": { "title": "How can we improve this crawler for you?", "minLength": 1, "type": "string", "description": "Provide any feedback or suggestions for improvements." }, "sp_contact": { "title": "Contact Email", "minLength": 1, "type": "string", "description": "Provide your email address so we can get in touch with you." }, "competitions": { "title": "Competitions", "type": "array", "description": "List of competition keys to download. Options: ipl, t20s, tests, t20_wc, it20s, odi, wt20s, wtests, wodis, the_hundred, wbbl, bbl, cpl, psl, sa20, ipl_w, lpl, sma. Leave empty to download all T20Is + IPL.", "items": { "type": "string" } }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum number of delivery records to output (0 = unlimited)" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```