Listings (search presets)

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

POST /v1/listings/for-sale

POST /v1/listings/for-rent

POST /v1/listings/sold

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

curl https://api.zillapi.com/v1/listings/for-sale \
  -H "Authorization: Bearer $ZILLOW_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "filters": {
      "location": "Austin, TX",
      "price": { "min": 400000, "max": 800000 },
      "beds": { "min": 3 },
      "homeTypes": ["house", "townhouse"]
    },
    "maxItems": 50
  }'

GET /v1/listings

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 if no location
location	string	required if no bbox
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

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.