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'slookup_property_by_addressinstead
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(defaultfor_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.