| name | zillow-search |
| version | 1.0.1 |
| description | Search U.S. property listings by location or bounding box, price, beds, and home type via Zillapi.com. |
| license | MIT-0 |
| author | Zillapi |
| homepage | https://zillapi.com |
| repository | https://github.com/nikhonit/zillow-skills |
| tags | ["zillow","real-estate","listings","search","api","mcp"] |
| metadata | {"openclaw":{"primaryEnv":"ZILLAPI_KEY","homepage":"https://zillapi.com","requires":{"env":["ZILLAPI_KEY"]}}} |
zillow-search
Focused listing-search skill. Use only when the user explicitly asks to find homes matching a set of criteria — not when an address or location merely appears in passing.
When to use this skill
DO use when the user asks:
- "Find 3-bedroom houses under $500k in Austin, TX"
- "What's for rent under $2,500 in 78704?"
- "Show me sold comparables for this neighborhood in the last 90 days"
- "Search for waterfront condos in Miami"
Do NOT use when:
- A location appears incidentally in context
- The user mentions an area without asking to search for listings there
- The user has a single known property in mind — use
zillow-full's lookup_property_by_address instead
Each result returned consumes one credit. For broad queries, narrow the filters or cap max_items before calling.
Tools
search_listings — 1 credit per result, up to 50
Search active for-sale, for-rent, or sold listings.
Filters:
location — city, ZIP, neighborhood string (e.g. "Austin, TX", "78704", "Brooklyn, NY")bbox — "west,south,east,north" decimal degrees (alternative to location)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
Pass either location or bbox — at least one is required.
Authentication
Set ZILLAPI_KEY to your Zillapi API key (format zk_...). Free key with 100 credits at https://zillapi.com/signup — no card.
Pricing
| Plan | Price | Credits | Rate limit | Top-ups |
|---|
| Free | $0 | 100 (one-time) | 20/min | not available |
| Monthly | $5/mo | 1,000/month | 200/min | $4 per 1,000 |
| Annual | $54/yr | 12,000 upfront | 300/min | $3 per 1,000 |
One credit per listing returned. A search returning 25 results consumes 25 credits.
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.
