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 lookuppropertyby_address instead.

Tool

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: forsale | forrent | sold (default for_sale)
• pricemin, pricemax: integer dollars
• bedsmin, bedsmax, bathsmin, bathsmax: integers
• sqftmin, sqftmax, yearbuiltmin, yearbuiltmax: integers
• hometypes: comma-separated subset of house, condo, townhouse, multifamily, manufactured, lot, apartment
• daysonzillow: 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 ZILLAPIKEY to your Zillapi API key (format zk...).

export ZILLAPI_KEY="zk_..."

Free key at <https://zillapi.com/signup>;: 100 credits, no card required. Plans and current prices: <https://zillapi.com/pricing/>;. 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: <https://zillapi.com/openapi.json>;
• REST docs: <https://zillapi.com/api/properties/>;
• Hosted MCP server (alternative to this skill): <https://api.zillapi.com/mcp>;

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.