Skip to content
Zillow API

Listings (search presets)

Conveniences over POST /v1/search for the most common use cases.

POST /v1/listings/for-sale

Cost · 1 credit per listing returned (minimum 1) · failed calls are free

POST /v1/listings/for-rent

Cost · 1 credit per listing returned (minimum 1) · failed calls are free

POST /v1/listings/sold

Cost · 1 credit per listing returned (minimum 1) · failed calls are free

Same body shape as /v1/search, with filters.status forced. See Search for the full filter schema.

Terminal window
curl https://api.zillapi.com/v1/listings/for-sale \
  -H "Authorization: Bearer $ZILLOW_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "filters": {
      "bbox": { "west": -97.94, "south": 30.10, "east": -97.56, "north": 30.52 },
      "price": { "min": 400000, "max": 800000 },
      "beds": { "min": 3 },
      "homeTypes": ["house", "townhouse"]
    },
    "maxItems": 50
  }'

bbox is required. location is accepted as a decorative usersSearchTerm hint but on its own returns 400 invalid_filters, see Search for why.

GET /v1/listings

Cost · 1 credit per listing returned (minimum 1) · failed calls are free

A REST GET wrapper. Useful when you want a one-line curl or to pass via a URL shortener / agent toolchain.

Query Type Notes
status for_sale|for_rent|sold default for_sale
bbox west,south,east,north (numbers, comma-separated) required
location string optional; decorative usersSearchTerm only
price_min, price_max int dollars
beds_min, beds_max int
baths_min, baths_max int
sqft_min, sqft_max int
year_built_min, year_built_max int
home_types comma-separated of house,condo,townhouse,multi_family,manufactured,lot,apartment
days_on_zillow 1|7|14|30|90|6m|12m|24m|36m
max_items int up to 50 in sync mode
format json|csv|ndjson default json
Terminal window
curl 'https://api.zillapi.com/v1/listings?status=for_sale&bbox=-122.55,37.70,-122.35,37.85&beds_min=2&price_max=1500000&max_items=50' \
  -H "Authorization: Bearer $ZILLOW_API_KEY"

For more than 50 results in one call, switch to POST /v1/search with async: true.