# Changelog of Suumo.jp Japan Real Estate Scraper (`devilscrapes/suumo-japan-real-estate`) Actor

- **URL**: https://apify.com/devilscrapes/suumo-japan-real-estate/changelog.md
- **Full Actor documentation**: https://apify.com/devilscrapes/suumo-japan-real-estate.md

## Changelog — suumo-japan-real-estate

### 0.2 (unreleased)

- **BREAKING**: `nearest_station`/`walk_minutes` removed from the dataset
  schema, replaced with `stations: [{line, station, walk_minutes}, ...]` —
  every nearby-station line on the card (rent: 1-3, buy: 1), not just the
  first. Scripts reading the old two fields must migrate.
- Minimal buy-mode (`bukken`/used-condo) search-page parsing —
  `.property_unit` cards, new `listing_mode: "rent" | "buy"` field on
  every row.
- Opt-in `fetchListingDetails` input flag: fetches each listing's detail
  page and back-fills `agency_name`/`agency_phone` (rent) or
  `agency_name`/`management_fee_yen`/`floor` (buy). Detail fetches reuse
  the existing backoff/retry/impersonation pipeline; a per-row miss
  leaves the new fields `None` and never fails the run.
- New `detail-enriched` PPE event ($0.005/row, charged only when a
  detail fetch yields an agency name) — **requires manual registration
  in Apify Console before it will actually bill**; see Risks in
  `docs/specs/suumo-japan-real-estate/design.md`.
- Corrected `deposit_yen`/`key_money_yen` field descriptions — these are
  direct Yen amounts as displayed, not rent-multiples (the v0.1
  docstring was overly cautious/wrong).
- Updated confirmed search URLs (`sc=13104`) used as the `searchUrls`
  prefill and in the dev/QA input fixtures.

### 0.1 — initial publish (2026-06-07)

- Full scraper implementation: curl-cffi + parsel HTML parsing of Suumo.jp chintai/baikyaku search pages.
- 16 structured fields per listing: listing\_id, name, url, property\_type, price\_yen, management\_fee\_yen, deposit\_yen, key\_money\_yen, address, nearest\_station, walk\_minutes, layout, area\_sqm, floor, building\_age\_years, scraped\_at.
- Automatic pagination with configurable maxPages and maxItems caps.
- Residential proxy rotation via Apify Proxy; exponential backoff on 408/429/503.
- PPE events: actor-start ($0.005) + result ($0.0025/row) → ~$2.50 per 1 000 results.
- 54 hermetic tests passing; cloud QA PASS (runId=CzeE1KpGAZ8VlMZlQ, 5 items, SUCCEEDED).