Zillow Full

SKILL.md

---
name: zillow-full
version: 1.0.1
description: Complete Zillow property data toolkit via Zillapi.com. Nine tools — address/URL/zpid lookup, Zestimate, listings search, photos, schools, price history, agent contact.
license: MIT-0
author: Zillapi
homepage: https://zillapi.com
repository: https://github.com/nikhonit/zillow-skills
tags:
  - zillow
  - real-estate
  - property-data
  - zestimate
  - listings
  - api
  - mcp
metadata:
  openclaw:
    primaryEnv: ZILLAPI_KEY
    homepage: https://zillapi.com
    requires:
      env:
        - ZILLAPI_KEY
---

# zillow-full

Complete Zillow property data toolkit via Zillapi.com. Use when the user **explicitly asks** about a U.S. property, its value, listings to buy or rent, or related real-estate data.

## When to use this skill

Each tool call consumes Zillapi credits, so this skill activates only when the user's request is genuinely about real-estate data — not when an address or Zillow link merely appears in passing.

**DO use when the user:**

- Asks about a Zestimate, property value, rent estimate, or tax-assessed value → `get_zestimate`
- Pastes a Zillow URL and asks about that property → `lookup_property_by_url`
- Gives an address and asks about the property, schools, photos, or agent → `lookup_property_by_address`
- Asks to find homes matching criteria (location, price range, beds, baths) → `search_listings`
- Asks for the price history, last sale, or ownership timeline of a known property → `get_price_history`
- Asks for the listing agent or broker contact → `get_listing_agent`
- Asks what schools serve a property → `get_property_schools`
- Asks to see photos of a property → `get_property_photos`

**Do NOT use when:**

- An address appears incidentally in context (email signatures, news articles, copy-pasted unrelated content)
- The user is discussing real estate abstractly without asking for data on a specific property or listing search
- The user has not signaled they want a property lookup

When the intent is ambiguous, ask the user to confirm before calling a tool. These tools cost credits and return large records the user may not want.

## Tools

### `lookup_property_by_address` — 1 credit
Look up a single property by U.S. address. Returns the full property record: price, beds, baths, sqft, year built, lot size, Zestimate, rent Zestimate, tax assessed value, price history, photos, schools, agent contact, lat/lon, home type, home status, and 250+ additional fields.

Use this when the user gives an address. Address strings as loose as `123 Main St, Austin TX` work — the API tolerates partial addresses ≥6 characters.

### `lookup_property_by_url` — 1 credit
Same as above but takes a Zillow.com URL. Use this when the user pastes a `zillow.com/homedetails/...` link.

### `lookup_property_by_zpid` — 1 credit (cache-served when fresh)
Look up a property by Zillow zpid. Use this when you already have the zpid from a previous call. Cheaper because the response can be served from cache.

### `get_zestimate` — 1 credit
Get just the Zestimate, rent Zestimate, tax-assessed value, and last-sold price for a property. Use this when you only need the valuation, not the full record.

### `search_listings` — 1 credit per result, up to 50
Search active for-sale, for-rent, or sold listings. Filter by location (city/state/ZIP) or bounding box, price, beds, baths, sqft, year built, home type, and days on Zillow.

### `get_price_history` — 1 credit
Get the price and listing-status history for a property (list price changes, sale prices, withdrawals).

### `get_property_photos` — 1 credit
Get the photo gallery for a property (responsive image URLs at multiple resolutions).

### `get_property_schools` — 1 credit
Get the assigned elementary, middle, and high schools for a property with GreatSchools ratings.

### `get_listing_agent` — 1 credit
Get the listing agent and broker contact (name, email, phone, license number) for an active listing.

## Authentication

Set `ZILLAPI_KEY` to your Zillapi API key. Keys are `zk_...` strings.

```bash
export ZILLAPI_KEY="zk_..."
```

Get a free key with 100 credits at <https://zillapi.com/signup> — no card required.

## 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 equals one property record returned. Failed calls do not consume credits. Top-ups are available on Monthly and Annual plans only.

## Errors

All functions return a Python dict. On success the dict contains the API response. On failure the dict contains an `error` key:

- `{"error": "auth", ...}` — `ZILLAPI_KEY` is missing or invalid
- `{"error": "HTTP 404", ...}` — property not found
- `{"error": "HTTP 429", ...}` — rate-limited; back off and retry
- `{"error": "network", ...}` — DNS/connection failure

## API reference

- OpenAPI spec: <https://zillapi.com/openapi.json>
- REST docs: <https://zillapi.com/api/properties/>
- Hosted MCP server (alternative to this skill): <https://api.zillapi.com/mcp>

## Trademark

Zillapi is an independent service and is not affiliated with, endorsed by, or sponsored by Zillow Group, Inc. "Zillow" and "Zestimate" are registered trademarks of Zillow Group, Inc.