Zillow Search

SKILL.md

---
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`](https://github.com/nikhonit/zillow-skills/tree/main/skills/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 <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.