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.
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: 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 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
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.
1---2name: zillow-search3description: Searches US property listings for sale, for rent or sold via the zillapi API, filtered by location or bounding box, price, beds, baths, square footage, year built, home type and days on Zillow. Use when the user asks to find homes, condos, apartments, rentals, sold comparables or listings matching criteria in a city, ZIP or area. Do not use for a single known property (zillow-full covers lookups) or when a location appears incidentally. Each returned listing costs one credit, so keep max_items tight.4license: MIT-05---67# zillow-search89Listing-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.1011For one known property use [zillow-full](https://github.com/ZeroPointRepo/zillow-skills/tree/main/skills/zillow-full)'s `lookup_property_by_address` instead.1213## Tool1415### `search_listings` (1 credit per result, up to 50)1617Pass either `location` or `bbox` (at least one required):1819- `location`: city, ZIP or neighborhood string (`"Austin, TX"`, `"78704"`, `"Brooklyn, NY"`)20- `bbox`: `"west,south,east,north"` in decimal degrees2122Filters:2324- `status`: `for_sale` | `for_rent` | `sold` (default `for_sale`)25- `price_min`, `price_max`: integer dollars26- `beds_min`, `beds_max`, `baths_min`, `baths_max`: integers27- `sqft_min`, `sqft_max`, `year_built_min`, `year_built_max`: integers28- `home_types`: comma-separated subset of `house`, `condo`, `townhouse`, `multi_family`, `manufactured`, `lot`, `apartment`29- `days_on_zillow`: one of `"1"`, `"7"`, `"14"`, `"30"`, `"90"`, `"6m"`, `"12m"`, `"24m"`, `"36m"`30- `max_items`: integer, capped at 50 per call3132A search returning 25 results consumes 25 credits.3334## Authentication3536Set `ZILLAPI_KEY` to your Zillapi API key (format `zk_...`).3738```bash39export ZILLAPI_KEY="zk_..."40```4142Free key at <https://zillapi.com/signup>: 100 credits, no card required. Plans and current prices: <https://zillapi.com/pricing/>. Failed calls are not charged.4344## Errors4546The handler returns dicts, never raises:4748- `{"error": "auth", ...}`: `ZILLAPI_KEY` missing or invalid49- `{"error": "HTTP 422", ...}`: bad filter values, check the parameter list above50- `{"error": "HTTP 429", ...}`: rate limited, back off and retry51- `{"error": "network", ...}`: DNS or connection failure5253## Reference5455- OpenAPI spec: <https://zillapi.com/openapi.json>56- REST docs: <https://zillapi.com/api/properties/>57- Hosted MCP server (alternative to this skill): <https://api.zillapi.com/mcp>5859## Trademark6061Zillapi 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.
ZeroPointRepo