# Changelog of Otodom Scraper – Polish Real Estate Listings (Sale & Rent) (`haketa/otodom-scraper`) Actor

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

## Changelog

### 1.1.0 — 2026-11-02

- **Fixed `agentName` (contact person) extraction.** The field was always empty because the scraper looked for legacy keys that Otodom no longer sends. It now reads the contact from Otodom's `advertOwner` block: for **private (FSBO) listings** this is the owner's name, and for **agency listings** it is the real human agent from `advertOwner.contacts[]` (distinct from the agency name). Coverage went from **0% to ~100%** in search results — a direct win for lead generation.
- **Verified against the live site:** a fresh run collected **290 unique de-duplicated apartment listings for sale in Warsaw** with **100% coverage** on `id`, `url`, `title`, `city`, `district`, `province`, `pricePerSquareMeter`, `isPrivateOwner` and `dealType`, and **99–100%** on `price`, `area`, `rooms`, `thumbnail`, `floor` and `features`. Zero duplicate IDs, zero value bugs.
- **Refreshed the README** with the exact fresh-run output sample, an accurate field-coverage reference, honest notes on search-only field limits (`latitude`/`longitude`/`market` live only on the individual offer page), and an expanded FAQ.
- Confirmed automatic pagination over Otodom's `__NEXT_DATA__` search metadata (one Warsaw apartment query reports 20,000+ listings across 550+ pages) with per-listing de-duplication by Otodom ID.

### 1.0.0 — 2026-10-25

- Added a `features` field exposing listing amenity tags (e.g. `BALCONY`, `TERRACE`, `PARKING_SPOT`, `SEPARATE_KITCHEN`, `BASEMENT`).
- Hardened `city` / `district` / `province` resolution so location fields populate reliably from Otodom's `reverseGeocoding` data even when the address block is empty.
- Initial public release: sale (sprzedaż) and rental (wynajem) scraping across all of Poland with owner-vs-agency detection, price/area/rooms filters, Start-URL support and automatic pagination.
