Collectors · Real estate

Zillow Property API in Python

Full detail per zpid — price, beds/baths, size, year, description, price history, photos. One POST from Python with properties, rows back as JSON with 54 fields, $0.005 per delivered property. No proxies or parsers to maintain.

Get an API key See the collector

A Python requests snippet that posts { — A Python requests call to the zillow_property collector returns one dict per property, at $0.005 each.

First call

Install, call, read the rows.

pip install requests

The only dependency.

import os, requests

r = requests.post(
    "https://api.quanticdata.io/v1/scraper/collectors/zillow_property/run",
    headers={"Authorization": f"Bearer {os.environ['QD_API_KEY']}"},
    json={
        "properties": ["29423772"],
        "max_results": 1,
    },
    timeout=120,
)
r.raise_for_status()
run = r.json()["payload"]
print(run["count"], "rows,", run["cost"]["usd"], "USD")
for row in run["results"]:
    print(row.get("zpid"), row.get("url"), row.get("address"), row.get("city"))

Python: one Zillow property details run (Un zpid), printing zpid, url, address, city

The key comes from an environment variable, never from the code. The run answers in the same request when it finishes in time; payload.results holds the rows and payload.cost what they cost.

Request parameters

What the collector takes.

Input of the Zillow property details collector
Parameter	Type	Required	Meaning
`properties`	array	yes	zpids or /homedetails/ URLs (zillow_search returns both).
`max_results`	integer	no (default 5)	How many properties to deliver at most (1–20). You pay only for delivered properties.

Response fields

54 fields per property.

Fields of each row (property)
Field	Type	What it holds
`zpid`	string	Zillow property id.
`url`	string	Home-details URL.
`address`	string, nullable	Street address.
`city`	string, nullable	City.
`state`	string, nullable	State.
`zipcode`	string, nullable	ZIP.
`status`	string, nullable	Listing status (FOR_SALE, SOLD…).
`home_type`	string, nullable	SINGLE_FAMILY, CONDO…
`price`	number, nullable	Listing price.
`currency`	string, nullable	Price currency.
`zestimate`	number, nullable	Zestimate when server-rendered.
`rent_zestimate`	number, nullable	Rent Zestimate when server-rendered.
`beds`	number, nullable	Bedrooms.
`baths`	number, nullable	Bathrooms.
`living_area`	number, nullable	Living area.
`living_area_unit`	string, nullable	sqft/m².
`lot_size`	number, nullable	Lot size value.
`lot_size_unit`	string, nullable	Lot size unit.
`year_built`	integer, nullable	Year built.
`latitude`	number, nullable	Latitude.
`longitude`	number, nullable	Longitude.
`description`	string, nullable	Listing description (first 1500 chars).
`last_sold_price`	number, nullable	Last sold price.
`date_sold`	string, nullable	Last sold date.
`price_history`	object[]	Recent price events ({ date, price, event }).
`brokerage`	string, nullable	Listing brokerage.
`mls_id`	string, nullable	MLS id.
`photo_count`	integer, nullable	Total photos on the listing.
`photos`	string[]	First photo URLs.
`country`	string, nullable	Country code as Zillow states it (USA).
`neighborhood`	string, nullable	Neighbourhood name.
`time_zone`	string, nullable	IANA time zone of the property.
`property_type`	string, nullable	Property type in words, e.g. "Single Family Residence".
`listing_type`	string, nullable	How it is listed: For Sale by Agent, For Sale by Owner, New Construction, Foreclosure, Auction, Coming Soon, Pending.
`mls_status`	string, nullable	Status as the MLS reports it (Active, Pending…).
`mls_name`	string, nullable	Name of the MLS the listing comes from.
`listing_updated`	string, nullable	When the listing was last updated at the source (YYYY-MM-DD HH:MM:SS).
`listing_contact_phone`	string, nullable	Phone number the listing publishes for enquiries.
`lot_size_sqft`	number, nullable	Lot size in square feet.
`price_per_sqft`	number, nullable	Price per square foot.
`days_on_zillow`	integer, nullable	Days on Zillow.
`price_change`	number, nullable	Latest price change; negative on a price cut.
`price_change_date`	string, nullable	Date of that change (YYYY-MM-DD).
`baths_full`	integer, nullable	Full bathrooms.
`baths_half`	integer, nullable	Half bathrooms.
`heating`	string, nullable	Heating as listed.
`cooling`	string, nullable	Cooling as listed.
`parking`	string, nullable	Parking as listed, e.g. "2 Attached Garage spaces".
`hoa`	string, nullable	HOA dues as listed, when stated.
`highlights`	string[], nullable	Short highlights Zillow extracts from the listing.
`open_houses`	object[], nullable	Scheduled open houses: start, end.
`virtual_tour_url`	string, nullable	3D home tour URL.
`is_showcase`	boolean	True for a Zillow Showcase listing.
`image`	string, nullable	Main photo URL.

Add ?format=csv to the runs endpoint to get the same rows as CSV.

Long runs

Run in the background, then poll.

A run that needs more time can go to the background: send "async": true, get 202 with the run id, and poll the runs endpoint until the status is done. Reading a run is free.

import os, time, requests

H = {"Authorization": f"Bearer {os.environ['QD_API_KEY']}"}
r = requests.post("https://api.quanticdata.io/v1/scraper/collectors/zillow_property/run", headers=H,
                  json={**{"properties":["29423772"],"max_results":1}, "async": True}, timeout=30)
run_id = r.json()["payload"]["run_id"]
while True:
    run = requests.get(f"https://api.quanticdata.io/v1/scraper/collectors/runs/{run_id}", headers=H, timeout=30).json()["payload"]
    if run["status"] in ("done", "failed"):
        break
    time.sleep(5)
print(run["status"], run["count"])

Python: background run and polling

Errors

What can come back, and what is billed.

Collector run errors
Status	Meaning	Billed
`400`	The input does not match the collector (`payload.errors`)	No
`401`	Missing or wrong API key	No
`402`	Balance and free credit do not cover the run: top up	No
`422`	The input can never resolve; retrying the same input cannot help	No
`424`	The run failed at the source (blocked, timed out, layout changed); safe to retry	No
`429`	Rate limit or a per-account brake; wait for `Retry-After`	No

Only delivered rows are billed: a run that delivers nothing costs nothing.

Price

$0.005 per delivered property.

What Zillow property details rows cost at list price
Rows	Cost
1	$0.005
1,000	$5.00
10,000	$50.00

Up to 20 properties per run; split larger jobs into several runs. The $2 free credit every month covers about 400 properties. No subscription; paid tiers lower the unit price. All collector prices: collector pricing.

Before you run it

Questions developers ask

Is there a free Zillow property details API?

Every account gets $2 of free usage each month, about 400 properties of this collector at $0.005 each, with no card.

Do I have to handle proxies, retries or blocks?

No. The collector runs on our network and handles them; a run blocked at the source returns 424 and is not billed.

How many rows can one run return?

Up to 20 properties per run (the max_results input, where the collector has one).

Can an AI agent run it?

Yes: the MCP server exposes it as the run_collector tool, with the same input and price. See the MCP server.

Run it on the free credit.

Create an API key, export it as QD_API_KEY and run the example. $0.005 per delivered property, no subscription.

Get an API key Zillow Property API