# Changelog of Zillow Market Data Scraper — ZHVI · Rent · Mortgage Rates (`sian.agency/zillow-market-analytics-scraper`) Actor

- **URL**: https://apify.com/sian.agency/zillow-market-analytics-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/sian.agency/zillow-market-analytics-scraper.md

## Changelog

All notable changes to Zillow Market Data Scraper will be documented in this file.

### \[2026-07-03]

#### 🔧 Fixed

- **Bare API runs work out of the box** - `searchQueries` now defaults to `["Austin, TX"]`, so runs started via API with an empty input `{}` (and Store TEST runs) return the full sample dataset instead of failing on missing input

### \[2026-05-21]

#### 🎉 Zillow Market Data Scraper — Launch!

- **Tidy-Long ZHVI Feed** - Pull 100 monthly Zillow Home Value Index points per US metro for REIT performance attribution and trend analysis
- **Rent Appreciation Tracker** - Capture 12-month median rent history + 47-bucket rent price histogram + 6 nearby-area comps + 10 zipcode trends per query
- **Daily Mortgage Rate API** - Refresh 16 loan products (30yr fixed, 15yr fixed, 20yr, 10yr, FHA, VA, ARM, Jumbo) with rate + APR + points
- **200 Rows per Metro Query** - ~106 housing-market + ~85 rental-market + 16 mortgage rows in one normalized stream, ready for BigQuery / Snowflake / pandas
- **6-Tier Pay-Per-Event Pricing** - BRONZE $0.005/row → DIAMOND $0.0015/row volume ladder; ~$1.00 per metro query at BRONZE
- **Multi-Area Batch Mode** - Process dozens of US metros, cities, or zipcodes in a single run via `searchQueries` array
- **Per-Source Toggles** - Switch off housing, rental, or mortgage endpoints to control row counts and spend
- **Stable Primary Keys** - `(source_type, location_id, metric_name, period_start)` lets you re-join historical loads without fuzzy matching
- **Full FREE-Tier Sample** - 1 area query returns the complete ~200-row sample (no truncation) — evaluate data quality before scaling
- **HTML Run Report** - Per-location and per-metric row-count summary saved to the key-value store for every run

#### 💎 User Benefits

- **Order-of-magnitude cheaper than ATTOM**: ~$1.00 per metro query vs $500–$5000/mo minimums on ATTOM, HouseCanary, Black Knight, and CoreLogic feeds
- **No preprocessing**: tidy-long shape drops straight into SQL warehouses and BI tools — no nested-blob parsing, no Python ETL gymnastics
- **One actor, three feeds**: ZHVI + rent + mortgage in a single normalized row stream — replace three vendor contracts with one Apify call
- **Production-ready primary keys**: stable `locationId` + `metricName` + `periodStart` makes incremental loads and historical re-joins trivial
- **Buyer-quality FREE tier**: complete time-series sample (all ~200 rows, no truncation) — evaluate the real product, not a hobbled demo

#### 🎯 Use Cases

- REIT analysts loading 100 monthly ZHVI points per metro into BigQuery for quarterly portfolio performance attribution
- PropTech engineers tracking 12-month rent appreciation + 47-bucket rent histograms per zipcode for build-to-rent underwriting
- Fintech teams refreshing 16 daily mortgage products to power customer-facing affordability calculators and pre-qual widgets
- Real-estate fund acquisition teams pulling nearby-area rent comps and zipcode trends for new-market diligence
- MLS data resellers replacing $500/mo ATTOM minimums with on-demand normalized ZHVI / rent / mortgage feeds at ~$1 per metro

#### 🐛 Known Limitations

- **Per-property time-series out of scope for v1.0**: upstream provider returns 2.4% success rate on per-property `/graph_charts` endpoints (Zestimate history, tax history, rent Zestimate history). Reintroduced in v1.1 when upstream coverage improves.
- For per-property data (Zestimate history, listing details, tax history), use the sister actor [Zillow Property Scraper](https://apify.com/sian.agency/zillow-property-scraper?fpr=sian) — different row shape entirely.

### \[Unreleased / v1.1 Backlog]

- `/graph_charts` per-property time-series (Zestimate history, tax assessment, tax paid, rent Zestimate history) — pending upstream coverage above 2.4% success rate
- Detail-level filters: limit ZHVI history to last N months, limit rent histogram to specific price brackets
- HTML report enhancements: per-source CSV download links, KPI summary cards (CAGR, YoY rent appreciation)