# Changelog of ZAP Imóveis Scraper (`haketa/zapimoveis-scraper`) Actor

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

## Changelog

### 1.1.0 — 2026-11-01

- **Fixed agency contact extraction (lead-gen).** `agencyPhone` now populates on **100%** of listings (previously 0%) by reading the public broker number from `listing.advertiserContact.phones[]` and the object-shaped `account.phones`. `agencyWebsite` and `agencyEmail` are now parsed from the agency's `websiteUrl` field (e-mails are split out correctly), bringing website coverage to ~55-60% and email to ~7-20% in listings mode.
- **Fixed image URLs.** `imageUrls` now resolves ZAP's `{description}/{action}/{width}x{height}` templates to concrete, directly-loadable URLs for every photo (previously 100% of entries contained unresolved placeholders). `thumbnailUrl` was already resolved and is unchanged.
- **Corrected `pageSize` guidance.** ZAP's API rejects pages larger than 24 ("Size is above acceptable limit"); the input schema maximum is now 24 and the help text updated to prevent silent zero-result runs.
- **Verified a fresh run of 450 unique São Paulo sale listings in ~36 s with 0 duplicates and no value bugs** — core identity fields (`listingId`, `url`, `title`, `priceBRL`, `usableArea`, `pricePerSqmBRL`, `city`, `neighborhood`, `uf`, `zipCode`, `unitType`, `agencyName`, `agencyPhone`, `imageUrls`) at 100% coverage; pagination confirmed against an 838k-listing result set.
- **Rewrote the README to the gold standard**, grounded in the fresh run: accurate output example and field table, honest coverage notes (which fields are data-dependent or mode-specific), a Pagination & scale section, an expanded FAQ, and a Related scrapers block. Removed claims for cross-portal fields (`alsoOnVivaReal`/`vivaRealId`) and `description`/`updatedAt` that the current search endpoint does not provide.

### 1.0.0 — 2026-05

- Initial public release — `listings` and `agencies` modes, ZAP Imóveis and VivaReal portals via the direct Glue API, lançamento support, Brazilian-specific flags (sem fiador, FGTS, MCMV), Brazilian residential proxy by default, and pay-per-event pricing.
