# Changelog of Urbania Scraper — Peru Property Data & API (`sian.agency/urbania-property-scraper`) Actor

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

## Changelog

All notable changes to Urbania Scraper — Peru Property Data & API will be documented in this file.

### \[2026-09-18]

#### 🐛 Fixed

- **Your search URLs are never ignored again** — if you pasted a search URL but left "Search mode" on its default, the actor quietly ran a nationwide search instead and billed it. It now uses the URLs you gave it and says so in the log.
- **Search URLs now really filter by district** — a pasted search URL like `urbania.pe/buscar/venta-de-departamentos-en-san-isidro--lima--lima` returned the same generic nationwide dataset no matter which district it named. Urbania keeps the district, property type and operation in the URL's path, and that part was being dropped when paging. Every search URL now returns exactly the listings the same URL shows on the site.
- **URLs that name no operation are no longer narrowed to "for sale"** — `/buscar/propiedades-en-…` now returns sale *and* rental listings, matching the live result count.

### \[2026-06-15]

#### 🎉 Urbania Scraper — Launch!

- **Overview Mode — Fast & Cheap** — a full record per listing straight from the search API (price in soles + USD, expenses, size, rooms, baths, parking, full location hierarchy, GPS, advertiser, photo gallery) across every Peruvian district
- **Detail Mode — Full Records** — the complete long description and the advertiser's WhatsApp for any Urbania listing, on top of every Overview field
- **Dual Currency on Every Row** — price in both soles (PEN) and US dollars (USD), with the missing side completed at the run's live exchange rate
- **Three Search Modes** — search by operation + filters, by a pasted Urbania search URL (your filters honored), or by specific listing URLs
- **Price-per-m² + GPS on Every Row** — analysis-ready Peruvian property data with coordinates for instant mapping and benchmarking
- **Advertiser Contact Built In** — agency name and WhatsApp on every listing for instant lead lists
- **No API Key, No Code** — a real-estate data feed for Peru with zero Urbania setup, exported as clean JSON / CSV / Excel

#### 💎 User Benefits

- Size a whole city's market in minutes instead of copying listings by hand
- Compare in soles or dollars without manual conversion — both are on every row
- Pay only for what you extract — Overview and Detail priced separately
- Free tier (25 listings/run) to try it with no credit card
- Self-documenting datasets: every row records the exact search (and FX rate) that produced it

#### 🎯 Use Cases

- Investors sourcing undervalued stock by price-per-m² vs district median
- Brokers building advertiser and lead lists for a target area
- Proptech teams powering AVMs and dashboards with a repeatable Peruvian property data feed
- Investors building rental-yield models from price, expenses and dual-currency on every row
- Appraisers pulling comparable listings (full description, specs, advertiser) for defensible CMAs
