# Changelog of realestate.com.au Scraper — AU Buy + Rent + Sold Listings (`sian.agency/realestate-au-property-scraper`) Actor

- **URL**: https://apify.com/sian.agency/realestate-au-property-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/sian.agency/realestate-au-property-scraper.md

## Changelog

All notable changes to **realestate.com.au Scraper — AU Buy + Rent + Sold Listings** will be documented in this file.

### 2026-07-02

#### 🏡 v0.1.7 — Property Lookup Modes + listing-type filter fix

- **NEW `propertyurls` mode** — paste an array of single-listing realestate.com.au URLs and get one full-detail row per listing: full description, every photo, agency block, agents with direct phone + email, inspections, auction time. Each successful lookup charges one `detail-enriched` event; unmatched URLs are never charged.
- **NEW `propertyaddresses` mode** — look up active on-market listings by plain street address (`unit/number street, suburb STATE postcode`) — same full-detail row, no listing id or URL needed. Perfect for CRM address lists and comps worksheets.
- **FIXED: rent & sold searches could return for-sale listings** — the listing-type filter was not being applied by the data source in all search modes; `listingType=rent` / `sold` now return the correct channel (verified live: Sydney rent searches now return actual rentals with weekly pricing).
- **FIXED: inspection times in full-detail data** — detail payloads deliver inspection windows under a different key style than search rows; `detail.inspections[].startTime/endTime` are now captured correctly instead of being dropped.

### 2026-05-19

#### 🎉 realestate.com.au Scraper — Launch (v1.0)

- **Buy + Rent + Sold in one actor** — sweep all three Australian channels per query (PAID); investors finally get live asking prices AND sold-archive comps in a single dataset.
- **6 search modes incl. polygon geofencing** — `bylocation` (free-text suburb), `byzip` (4-digit AU postcode), `bycoordinates` (lat/lon + km radius), `bypolygon` (closed lon-lat ring), `byurl` (paste realestate.com.au URL), `bulklocations` (array of suburbs, PAID).
- **Auction history + sold-date archive** — `listingType=sold` returns the sold price as `pricing.price`, the sold date in `modifiedDate`, and the auction timestamp in `auctionTime` for auctioned listings. Perfect for valuation comps and auction-clearance research.
- **A$ market KPIs out of the box** — median sale / rent / sold (AUD), distribution percentiles (min · median · avg · p90 · max), top-10 suburbs by listing count, state breakdown, property-type tally — computed in-run.
- **Optional `/details/byid` enrichment** — one toggle bundles full description, every photo, complete general/property feature lists, agency block, advertisers, inspections, and auction time per listing. PAID tier.
- **HTML market report** — auto-saved to the run's key-value store as `report.html`; investor / buyer's-agent ready, shareable as-is.

#### 💎 User Benefits

- **Underwrite Australian deals from data, not gut feel** — comps, sold prices, auction history, and suburb medians in one run.
- **Wedge pricing** — BRONZE ≈ **A$3 / 1,000 listings** ($0.0030 `property-extracted`), tapering to **≈ A$0.90 / 1,000 listings at DIAMOND** — cheaper than premium AU incumbents while shipping more search modes and richer KPIs.
- **No vendor lock-in** — clean JSON / CSV / Excel export from the Apify dataset UI; pipe straight into Airtable, PowerBI, Google Sheets, your AVM, or your buyer-agent CRM.
- **Charged only on success** — failed extractions and failed enrichments never fire a charge event; input is validated before any charge.
- **Triple-key resilience** — primary + 2 backup keys with silent rotation on 401 / 402 / 403 / 408 / 429 / 5xx upstream errors.

#### 🎯 Use Cases

- **Australian property investors** auto-pulling live + sold comps for any suburb or postcode, ranking by median sold price per beds/baths cohort.
- **Buy-side agents** bulk-sweeping client wishlists across multiple eastern-beaches / inner-city / sun-belt suburbs in one PAID run.
- **Valuation analysts** training hedonic AVMs on the sold-mode archive (sold price + sold date + auction history + agency block).
- **PropTech newsletters & agency CEOs** generating monthly suburb market updates with median, percentile distribution, property-type mix, top-10 suburb tally.
- **Real-estate agency intelligence teams** tracking market share by `agency.id` across postcodes — listing inventory per branch, WoW share movement, recruitment targets.

#### 🔧 Built-in Robustness

- Brand-only env vars — vendor upstream is never leaked in logs, errors, or dataset rows
- Triple-key fallback on quota / rate-limit / 5xx errors
- In-body quota detection — handles `HTTP 200 + { message: "402: Not enough credits" }` correctly
- Input validation runs **before** any charging
- `apify-actor-start`, `property-extracted`, `detail-enriched` — 3 clean charge events, all success-gated