# Changelog of SUUMO Scraper - Japan Property Listings (`redomic/suumo-scraper`) Actor

- **URL**: https://apify.com/redomic/suumo-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/redomic/suumo-scraper.md

### 0.1.15 - 2026-11-15

- Data rows use each listing’s detail page URL in `url`; run status and summary are written to the key-value store as `STATUS` and `SUMMARY` (not pushed to the dataset).

### 0.1.14 - 2026-11-15

- Add result filters for layout structure: `minLayoutRooms`, `maxLayoutRooms`, and `layoutType` (K/DK/LDK/R/ワンルーム/other), applied during search pagination before counting toward `maxItems`.

### 0.1.13 - 2026-11-14

- Add structured layout fields `layoutRooms` and `layoutType` (parsed from `layout`) to rental, sale, and new-condo rows, including detail-enriched rows, and expose them in dataset views.

### 0.1.11 - 2026-11-14

- Remove `_status` from the Overview dataset view, switch README output example to a Tokyo rental with `depositAmount`/`keyMoneyAmount` populated, and add fixture-backed coverage assertions for rental deposit/key-money fields.

### 0.1.10 - 2026-11-14

- Re-capture 2026-11-14 fixtures for canary/battery land and used-house inputs and add parser regression tests confirming live pages still parse into listing rows (no parser/site-change fix required).

### 0.1.9 - 2026-11-14

- Add `pricePerTsubo` (JPY per tsubo, 1 tsubo = 3.30579 m², rounded) to listing rows with `priceAmount` and `areaM2`, exposed in dataset views/docs for JP buyer comparisons.

### 0.1.8 - 2026-11-14

- Switch default/store-task input example and schema prefill to a Tokyo rental search so rental money fields (`monthlyTotalJpy`, `depositAmount`, `keyMoneyAmount`) are visible in preview rows.

### 0.1.7 - 2026-11-14

- Apply result filters to each page before counting rows toward `maxItems`, so filtered searches keep paginating until enough rows pass.

### 0.1.6 - 2026-11-13

- Add `monthlyCostAmount` (JPY) to rental listing rows as `priceAmount + managementFeeAmount` (missing/“-” fees treated as 0) to show true monthly renter cost.

### 0.1.5 - 2026-11-13

- Add per-listing `coverageScore` (0–1 field-fill metric over key buyer and detail fields); higher on detail-enriched rows (`fetchDetails`).

### 0.1.4 - 2026-11-13

- Add `pricePerM2` (priceAmount/areaM2, JPY/m²) on listing rows with area, including rent/sale/new-condo parsing.

### 0.1.3 - 2026-11-12

- Per-room rental expansion: each rentable unit on a `chintai` search card becomes its own flat row (per-unit `id`/`url`, rent, management fee, deposit, key money, layout, area, floor) while building/station/address fields are kept; sale parsing unchanged.

## Changelog

### 0.1.1 - 2026-11-11

- Reliability: multi-window fetch with 503/challenge detection, retry/backoff on fresh connections, and explicit retryable status. 503 or challenge pages are never sold as "0 results" or silent-empty success; runs require a parseable non-empty sample or fail retryably.

### 0.1.0 - 2026-11-11

- Resumable scraping: accepts `resumeCursor` to continue from the next unprocessed page and emits `resumeCursor`/`nextPage` in per-source status and summary rows when truncated, so resumed runs skip prior pages without duplicates.

- Optional `fetchDetails` (default false): fetch each listing detail page and enrich rent/sale rows with detail-only fields (structure, floors/units, direction, parking, handover/move-in, renovation/feature notes).

- First build: scrape SUUMO search/listing pages from `startUrls` (rent and sale) with normalized JPY prices, area, layout, station access, per-input status and summary rows.

- New-condo project pages (`/ms/shinchiku/`): one row per project with `priceAmount`/`priceMaxAmount`, `areaM2`/`areaMaxM2`, layouts and `handoverRaw`; "価格未定" stays null. Station names from `線/駅 徒歩N分` text. Fetches retry 5 times on a fresh connection with 1.5-12 s backoff.

- Monitor mode: reports new/changed/removed listings versus previous run state stored in a named key-value store.

- Search pagination: follows result pages (`&pn=`) up to `maxItems`; per-source status rows include `total`, `pages`, and `truncated` instead of silently returning only the first page.

### 0.1.2 - 2026-11-11

- Buyer-facing result filters: `minPriceYen`, `maxPriceYen`, `minAreaM2`, `maxAreaM2`, `maxWalkMinutes`, `layoutContains` applied after parsing/enrichment so large SUUMO searches can be narrowed to actionable listings. Unchanged behavior when filters omitted.

### 0.1.7 - 2026-11-13

- Add `monthlyTotalJpy` (rent + management fee) and `moveInCostJpy` (rent + management fee + deposit + key money) for rental rows, with component-sum tests.
- Split dataset views into `overview` and `details`; overview keeps first-view fields with low null rates and `pricePerM2` present.

### 0.1.12 - 2026-11-14

- Remove `_status` from the Details dataset view and add fixture-backed assertions that rental preview rows' `monthlyTotalJpy`, `moveInCostJpy`, and `pricePerM2` match their component values.