# Changelog of Marktstammdatenregister (MaStR) Scraper — German Energy Units (`haketa/marktstammdatenregister-scraper`) Actor

- **URL**: https://apify.com/haketa/marktstammdatenregister-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/haketa/marktstammdatenregister-scraper.md

## Changelog

### 1.1.0 — 2026-11-01

- **New: optional location enrichment.** Added an `includeLocation` input (off by default). When enabled, the scraper fetches each unit's public detail page and fills **city (Ort), postal code (PLZ), federal state (Bundesland), district (Landkreis), municipality (Gemeinde), cadastral parcel and WGS84 coordinates**. This closes the gap where the compact grid endpoint the actor pages through does not carry a unit's address — previously `city` and `postalCode` were always empty.
- **New output fields:** `state`, `district`, `municipality`, `latitude`, `longitude` (populated when `includeLocation` is on). Existing field names and the default output are unchanged, so current runs are unaffected.
- **Verified** the headline geography at scale: a fresh 300-unit solar run with `includeLocation` returned `city`, `postalCode`, `state`, `district` and `municipality` at **~99.7–100%** coverage in ~90s, de-duplicated with 0 duplicates.
- **Verified** the default (no-location) path is unchanged: a fresh 500-unit solar run returned **500 de-duplicated records in ~22s** with all core fields (`unitId`, `unitName`, `energySource`, `status`, `grossPowerKw`, `netPowerKw`, operator numbers, dates, `detailUrl`) at **100%** and `solarModuleCount` at ~99%.
- **Docs:** refreshed the README to the current output (new sample + full field reference with honest coverage notes), documented the `includeLocation` toggle, the 250-per-page pagination and the de-duplication behaviour.
- Enrichment runs with a 10-way concurrency pool, proxy rotation and per-page retries for stable large/deep runs.

### 1.0.0 — earlier

- Initial release: scrape the Marktstammdatenregister (MaStR) electricity/gas generation and consumption units via the public JSON grid.
- Filter by energy source, federal state, operational status, city, postal code, operator name and capacity range; sort by report date, capacity or commissioning.
- Multi-value filters fetched as a cartesian set of single-value sweeps and merged, de-duplicated by registry unit ID; 250 units per page with Apify Proxy rotation and retries.
