Zillow Scraper (Node.js): for-sale, rental and sold listings as JSON

Scrape Zillow search results for any city, ZIP code or neighbourhood into structured JSON: price, beds, baths, square feet, lot size, address parts, coordinates, Zestimate, rent Zestimate, tax assessed value, days on Zillow, sold date, broker, photos, and unit ranges for apartment buildings. Works for homes for sale, rentals and recently sold homes, with price and bedroom filters, up to 820 listings per search.

The scraper reads the same results page you see in a browser and takes the listing data Zillow embeds in it. Each page is requested from your own machine through a public Unbrowse tool; parsing happens locally, so you get every field Zillow sends, not a text summary. Without an Unbrowse key, or when that tool is unavailable, the scraper sends the same request straight to the site and parses it the same way.

Quick start

git clone https://github.com/unbrowse-ai/zillow-scraper && cd zillow-scraper && npm install
export UNBROWSE_API_KEY=ub_live_...        # optional; free key: https://unbrowse.ai

node index.mjs "Austin, TX" --max 100 > austin.json
node index.mjs "78704" --type FOR_RENT --min-beds 2 --max-price 3000 > rentals.json
node index.mjs "Denver, CO" --type SOLD --max 200 > sold.json
node index.mjs "https://www.zillow.com/austin-tx/rentals/" > from-url.json

Option	Default	Meaning
<place or URL>...		"City, ST", a ZIP code, a neighbourhood, or any zillow.com search URL
--type	FOR_SALE	FOR_SALE, FOR_RENT or SOLD
--max N	100	Listings per search (41 per page, 20 pages at most)
--min-price, --max-price		Sale price, or monthly rent for rentals
--min-beds, --max-beds, --min-baths		Room filters

From code:

import { scrape } from "./index.mjs";
const homes = await scrape("Brooklyn, NY", { type: "FOR_RENT", max: 50, minBeds: 1 });

Output

{
  "zpid": "58307080",
  "url": "https://www.zillow.com/homedetails/12301-Meuse-Cv-Austin-TX-78727/58307080_zpid/",
  "status": "FOR_SALE",
  "homeType": "SINGLE_FAMILY",
  "address": "12301 Meuse Cv, Austin, TX 78727",
  "city": "Austin", "state": "TX", "zipcode": "78727",
  "price": 560000, "priceText": "$560,000", "currency": "USD",
  "beds": 4, "baths": 3, "livingArea": 2188, "livingAreaUnit": "sqft",
  "lotArea": 10746.252, "lotAreaUnit": "sqft",
  "latitude": 30.420174, "longitude": -97.721825,
  "taxAssessedValue": 468295, "daysOnZillow": 2,
  "brokerName": "Christies Intl Real Estate Lone Star",
  "has3DModel": true,
  "photos": ["https://photos.zillowstatic.com/fp/5025df2ba7801c49db694840a82a7e84-p_e.jpg", "..."],
  "searchQuery": "Austin, TX", "totalResults": 5753
}

Fields

Field	Notes
zpid, id, url	zpid is Zillow's property id; buildings without one get id from their lot id
status, statusText, homeType	FOR_SALE / FOR_RENT / SOLD; SINGLE_FAMILY, CONDO, APARTMENT_BUILDING, ...
address, street, unit, city, state, zipcode	Split address
price, priceText, priceMax, currency	priceMax for buildings with a rent range
beds, bedsMax, baths, livingArea, lotArea (+ units)
latitude, longitude
zestimate, rentZestimate, taxAssessedValue	When Zillow shows them
daysOnZillow, dateSold, openHouse	dateSold as YYYY-MM-DD for sold homes
brokerName, flexText	Listing broker, the card's highlight text
isBuilding, buildingName, units[], availableUnits	Apartment buildings: one record with its units
isNewConstruction, isForeclosure, isFsbo, isComingSoon, has3DModel, hasVideo	Flags
imgSrc, photos[]	Photo URLs
searchQuery, totalResults, scrapedAt	Context

FAQ

Do I need a key? No. With a free Unbrowse key, the scraper runs Unbrowse's public zillow.com tool first, which tells your machine which request to send. Without a key, or when a tool is unavailable, it sends the same request directly with a normal browser user agent (one note: line on stderr says so). Either way the request leaves from your IP, and your key is never sent to the site.

Zillow showed a "press and hold" check. The scraper closes the session without reporting the page and throws RefusedError. Slow down (--max smaller), wait, or use another network.

Can I get more than 820 results? Zillow itself stops at 20 pages. Split the area: search ZIP codes or add price bands.

Property detail pages? Not yet. The search cards already carry most of the numbers; detail pages are a good first contribution.

---

Part of open-scrapers: more scrapers and a catalog of 2,400+ websites callable as APIs or MCP servers.