zillow-search
Listing-search skill. Fire only on an explicit search request. Credits scale with results (1 per listing returned), so narrow filters and cap max_items before calling; confirm with the user when a query looks broad.
For one known property use zillow-full's lookup_property_by_address instead.
search_listings (1 credit per result, up to 50)
Pass either location or bbox (at least one required):
location: city, ZIP or neighborhood string ("Austin, TX", "78704", "Brooklyn, NY")bbox: "west,south,east,north" in decimal degrees
Filters:
status: for_sale | for_rent | sold (default for_sale)price_min, price_max: integer dollarsbeds_min, beds_max, baths_min, baths_max: integerssqft_min, sqft_max, year_built_min, year_built_max: integershome_types: comma-separated subset of house, condo, townhouse, multi_family, manufactured, lot, apartmentdays_on_zillow: one of "1", "7", "14", "30", "90", "6m", "12m", "24m", "36m"max_items: integer, capped at 50 per call
A search returning 25 results consumes 25 credits.
Authentication
Set ZILLAPI_KEY to your Zillapi API key (format zk_...).
export ZILLAPI_KEY="zk_..."
Free key at : 100 credits, no card required. Plans and current prices: . Failed calls are not charged.
Errors
The handler returns dicts, never raises:
{"error": "auth", ...}: ZILLAPI_KEY missing or invalid{"error": "HTTP 422", ...}: bad filter values, check the parameter list above{"error": "HTTP 429", ...}: rate limited, back off and retry{"error": "network", ...}: DNS or connection failure
Reference
- OpenAPI spec:
- REST docs:
- Hosted MCP server (alternative to this skill):
Trademark
Zillapi is an independent service and is not affiliated with, endorsed by, or sponsored by Zillow Group, Inc. "Zillow" is a registered trademark of Zillow Group, Inc.