Zillow API docs

Send a Zillow link or an address. Get back the listing price, status, Zestimate, rent Zestimate, home facts, photos, price history, tax history and broker as JSON.

Base URL and authentication

All endpoints live under https://api.propertiesapi.com/v1. Send your key in the x-api-key header. Requests without a key get 401 missing_api_key; an unknown key gets 401 invalid_api_key.

curl -G "https://api.propertiesapi.com/v1/zillow/property" \
  -H "x-api-key: $PROPERTIESAPI_KEY" \
  --data-urlencode "address=1600 Main St, Austin, TX 78701"

Endpoints

The response

A successful lookup returns { data, meta }. data is the property, with camelCase fields. The main ones:

• zpid, detailUrl, address (plus streetAddress, unit, city, state, zipcode, latitude, longitude): which property this is.
• homeStatus, statusText and price: the listing status and listing price. A sold home whose sale price isn't disclosed has price: null, never 0.
• Apartment buildings (zillow.com/apartments/... links): you get the building, and price, beds, baths, livingArea and unit describe its lowest-priced unit available now (no move-in date, or one on or before the lookup date; if none is available yet, its lowest-priced unit). The other units aren't returned yet.
• zestimate and rentZestimate: Zillow's estimates, when Zillow shows them.
• beds, baths, livingArea, lotSize, yearBuilt, homeType: the home facts.
• daysOnZillow, imgSrc and photos (a list of image URLs).
• priceHistory, taxHistory and schools: lists of past events, tax years and nearby schools.
• brokerName, agentName and their phones: who listed it.

meta has credits, cached, cache_key, fetched_at, source and took_ms. See every field on the property endpoint page.

Null fields

If Zillow doesn't show a field for a property, it comes back as null. Lists come back empty. Don't treat null as zero.

Latency

A live lookup (x-cache: MISS) takes typically 8 seconds, up to about 20. Set a client timeout of at least 120 seconds: an occasional lookup takes longer. Repeat lookups of the same home within 24 hours come from our cache and are free. For many properties, use batch instead of calling one at a time.

Errors

Errors use standard HTTP status codes and one JSON shape, { error: { code, message, details? }, meta: { took_ms } }:

{
  "error": {
    "code": "not_found",
    "message": "No Zillow property matches this input"
  },
  "meta": {
    "took_ms": 11840
  }
}

Retry 500, 502, 503 and 504 with exponential backoff (on 503, honor retry-after). Don't retry 4xx errors without changing the request. Errors aren't billed.

Headers and plans

Responses carry these headers:

Plans:

Overage on paid plans: your plan's own per-lookup rate ($11.60 per 1,000 on Starter, down to $7.68 on Scale). When paid plans open, there will be no cap on usage: after your included lookups, each lookup will be billed at your plan's rate, and you'll be able to set an optional monthly limit. Repeat lookups of the same home within 24 hours come from our cache and are free. Zillow links and addresses cost the same: 1 credit per successful lookup. Batch takes up to 50 items per request. See pricing for details.

OpenAPI spec

Download /openapi.json (OpenAPI 3.1). It's generated from the same definitions as these pages.

Acceptable use

The data is provided as-is, without any guarantee of accuracy or completeness. Don't use it for consumer reports or decisions covered by the FCRA, such as credit, insurance, employment or tenant screening.

Zillow is a trademark of Zillow, Inc. PropertiesAPI is an independent service and is not affiliated with, endorsed by or sponsored by Zillow.