Question 1

What do I give it and what do I get back?

Accepted Answer

You give it a US street address. It returns one JSON record with up to 40 fields — the Redfin Estimate, price and price history, tax assessment, beds, baths, sqft, year built, lot size, property type, county/FIPS/APN, lat/long, MLS number, listing description and agent, assigned schools, climate-risk scores, amenities, and the photo gallery — or { "found": false } if no source has a match.

Question 2

Does it return the Redfin Estimate / a valuation?

Accepted Answer

Yes — data.estimatedValue is the Redfin Estimate, Redfin's own automated valuation, in whole dollars. It came back on every address we tested, including sold and off-market homes. It is Redfin's number, not ours and not a Zestimate; the Zillow path has no valuation field.

Question 3

Which sources are supported?

Accepted Answer

Redfin and Zillow. Redfin is the reliable path, works without a proxy, and is where the full 40-field record comes from. Zillow sits behind PerimeterX and returns only the core physical facts; enable the residential proxy option to reach it. The default source 'auto' tries Redfin first, and adds Zillow as a fallback only when the proxy is on.

Question 4

How am I charged?

Accepted Answer

Pay-per-event: one charge per successful lookup (a match with address, city, and ZIP). Not-found or blocked lookups are free, so you never pay for a miss.

Question 5

Why does it need a real browser?

Accepted Answer

Redfin and Zillow block plain HTTP requests on TLS/browser fingerprint (not just IP), so curl, a bare fetch, and datacenter proxies all get 403/429. Driving a real browser gets past that and reads each site's own structured data.

Question 6

Do I need a proxy?

Accepted Answer

No for Redfin (it works direct at low volume). For Zillow, or for higher volume, turn on the residential proxy option; there's a useProxy input for exactly this.

Question 7

Does it return listing photos?

Accepted Answer

Yes — the data.images array gives the listing's photo gallery as full-size image URLs in order (the first is the hero), each with width and height. The URLs are public CDN links you can load directly in an <img> tag. A home with no gallery (many off-market/sold listings) returns an empty array; photos are supported on Redfin today.

Question 8

Is this personal data?

Accepted Answer

It returns public property facts, plus the listing agent's and brokerage's names exactly as they are published on the public listing page — that is business contact information, not private data. It does no owner lookup and adds no PII enrichment: there is no owner name, phone, email, or occupant data in the output.

Question 9

Why are some fields missing from my result?

Accepted Answer

Unknown fields are omitted rather than returned as null or 0, so what is present is real. Valuation, status, geo and county come back on effectively any resolvable address. Tax assessment needs a public county record, and MLS number, listing description and agent need an MLS record — a never-listed or off-market home simply won't have those keys.

Question 10

How current is the data?

Accepted Answer

It reflects each site's live data at run time, so the facts are as current as Redfin's/Zillow's own published records. Values are passed through as published — including the assessment roll year in data.taxYear, which is whatever the county last filed rather than the current year.

Field	Type
`query`	string\|null
`found`	boolean\|null
`source`	string\|null
`address`	string\|null
`city`	string\|null
`state`	string\|null
`zip`	string\|null
`beds`	integer\|null
`baths`	number\|null
`sqft`	integer\|null
`yearBuilt`	integer\|null
`lotSizeSqft`	integer\|null
`propertyType`	string\|null
`sourceUrl`	string\|null
`estimatedValue`	integer\|null
`price`	integer\|null
`priceLabel`	string\|null
`pricePerSqft`	number\|null
`lastSoldDate`	string\|null
`status`	string\|null
`latitude`	number\|null
`longitude`	number\|null
`county`	string\|null
`fips`	string\|null
`apn`	string\|null
`mlsId`	string\|null
`stories`	number\|null
`yearRenovated`	integer\|null
`fullBaths`	integer\|null
`halfBaths`	integer\|null
`taxAssessedValue`	integer\|null
`taxAssessedLand`	integer\|null
`taxAssessedImprovement`	integer\|null
`taxesDue`	number\|null
`taxYear`	integer\|null
`description`	string\|null
`listingAgent`	string\|null
`listingBroker`	string\|null
`priceHistory`	array\|null
`amenities`	object\|null
`schools`	array\|null
`riskFactors`	object\|null
`images`	array\|null

Field	Type	Req	Default	Description
`address`	string	no	`"745 Garland Dr, Palo Alto, CA 94303"`	Full US property address, e.g. '745 Garland Dr, Palo Alto, CA 94303'. To look up several properties, use 'Property addresses' below — one run handles the whole list on a single browser, which is faster and cheaper than a run per address.
`addresses`	array	no	`["745 Garland Dr, Palo Alto, CA 94303","1600 Amphitheatre Pkwy, Mountain View, CA 94043"]`	Look up many properties in ONE run. Each address is scraped on the same warm browser and pushed as its own row, so a batch is substantially faster than starting a run per address. Combined with 'Property address' if you fill both, and duplicates are removed. Billing is unchanged: you are charged per matched property, not per address submitted.
`source`	string	no	`"auto"`	Which site to look the property up on. 'Auto' tries Redfin first and only falls back to Zillow when the residential proxy is on (Zillow is PerimeterX-gated, so a direct attempt just wastes time). Pick a single source to pin the lookup to it.
`useProxy`	boolean	no	`false`	Route the browser through Apify residential proxy. Default off (direct). Turn on only for IP rate-limiting at volume or to help pass Zillow's PerimeterX.