# Changelog of Cricket Data API: ESPNcricinfo StatsGuru Export (`getascraper/espncricinfo-statsguru-scraper`) Actor

- **URL**: https://apify.com/getascraper/espncricinfo-statsguru-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/getascraper/espncricinfo-statsguru-scraper.md

## Changelog

All notable changes to this project will be documented in this file.

### \[0.2.4] - 2026-07-26

#### Added

- 🔗 Added player-profile and StatsGuru ground-query URL filters that safely resolve verified IDs without an extra network lookup.
- ⚖️ Added bounded multi-player fan-out for up to 20 unique player IDs or profile URLs.
- 🧾 Added player and ground filter provenance to every applicable raw row and form summary.

#### Improved

- 🔎 Expanded Store and search-engine coverage for cricket data APIs, ESPNcricinfo datasets, and StatsGuru exports.
- 💳 Added the active raw-record pricing anchor to the Store description for clearer evaluation.
- 🎯 Enforced `maxItems` globally, distributed its budget across requested players, and removed deterministic duplicate rows.

### \[0.2.3] - 2026-07-26

#### Improved

- 🏏 Changed the Store prefill to a five-innings India versus Australia T20I form analysis.
- ⚡ Limited the prefilled source set to 50 records so first-time users reach the player summaries quickly.
- 🔌 Kept the existing raw-export API defaults unchanged for integrations and saved tasks.

### \[0.2.2] - 2026-07-26

#### Added

- 💳 Added a safe publisher-only rollout guard for the custom `form-summary` pay-per-event charge.
- 🧾 Form mode can now charge exactly once per emitted player summary and stops before emitting an unchargeable summary.
- 🔗 Added a direct Form & Matchup Summary output link.

#### Changed

- 🛡️ The custom event is never called until its pricing configuration is live, preventing unknown-event warnings.

### \[0.2.1] - 2026-07-25

#### Fixed

- 🧭 Extracted and tested StatsGuru URL construction, including field-aware ascending/descending sort semantics.
- ✅ Added strict validation for query enums, dates, and positive numeric ground/player IDs.
- 🛡️ Genuine empty queries, blocked pages, and malformed responses are now handled as distinct outcomes.
- 👤 Recent-form grouping now prefers stable player IDs, with normalized names only as a fallback.
- 🎯 Bowling form calculations now respect StatsGuru's balls-per-over value.
- 🔗 Added resolved filters and the exact source query URL to provenance fields.
- ⚠️ Added an explicit warning when `maxItems` truncates a result set.

### \[0.2] - 2026-07-24

#### Added

- ✨ Added Form & Matchup Analysis: a ready-to-use recent-form summary for each player.
- ➕ Added a configurable recent-innings window and filters for opponent, team, venue, date, and result context.
- 📊 Added a dedicated Form & Matchup Analysis dataset view for batting and bowling summaries.

#### Changed

- ⚡ Form analysis uses a bounded source-record limit, keeping runs predictable and efficient.
- 🧭 Common international team names now work directly in Team and Opposition filters.