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 dollars
• beds_min, beds_max, baths_min, baths_max — integers
• sqft_min, sqft_max, year_built_min, year_built_max — integers
• home_types — comma-separated subset of: house, condo, townhouse, multi_family, manufactured, lot, apartment
• days_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 \x3Chttps://zillapi.com/signup> — no card.

Pricing

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.