# Zillow Property Search API (x402)

> Zillow Property Search API (x402) is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Searches Zillow listings by ZIP code and filters, returning structured property data for sale, rent, or recently sold homes.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/zillow-search?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/zillow-property-search-api-x402-59cc4b16
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QU17oHCMtlsqELsNjJtLA

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability zillow-property-search-api-x402-59cc4b16 -d '<json body>'
```

Example prompt: Search Zillow for homes for sale in ZIP codes 10001 and 10002 with at least 2 bedrooms priced between $500,000 and $1,500,000, listed in the last 30 days — give me up to 50 results per ZIP code.

## When to prefer this

Choose this endpoint when you need structured Zillow listing data — property URLs, IDs, and status — for one or more specific US ZIP codes without building your own Zillow scraper. It is ideal for real estate research agents, market analysis tools, or any workflow that needs to programmatically query active, rental, or sold listings with price and bedroom filters. It is pay-per-call with no charge for empty results, making it cost-effective for exploratory searches.

## Known failure modes

- ZIP code not found or invalid — empty items array returned, no charge
- No listings match filters — empty result, no charge
- Zillow rate-limiting or structure change — may return error or partial data
- Invalid filter combination (e.g. priceMin > priceMax) — likely empty or error response
- Network timeout — request fails, no charge per policy

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object with a count of matched listings and an array of items, each containing the Zillow property ID (zpid), home type, listing status text, property URL, listing status code, the ZIP code that matched, the source search URL, and the provider listing ID. Failed or empty searches are not charged.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sold": {
   "type": "boolean",
   "default": false,
   "description": "Include recently sold properties."
  },
  "forRent": {
   "type": "boolean",
   "default": false,
   "description": "Include rental homes and apartment buildings."
  },
  "minBeds": {
   "type": "integer",
   "minimum": 0,
   "description": "Minimum bedroom count; applies to matching listing categories."
  },
  "maxItems": {
   "type": "integer",
   "default": 0,
   "minimum": 0,
   "description": "Hard result cap across all ZIP codes. Zero means no additional cap."
  },
  "priceMax": {
   "type": "integer",
   "minimum": 1,
   "description": "Maximum sale price or monthly rent, depending on the listing category."
  },
  "priceMin": {
   "type": "integer",
   "minimum": 0,
   "description": "Minimum sale price or monthly rent, depending on the listing category."
  },
  "zipCodes": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Five-digit US ZIP codes to search. Keep leading zeroes as text."
  },
  "daysOnZillow": {
   "enum": [
    "",
    "1",
    "7",
    "14",
    "30",
    "90",
    "6m",
    "12m",
    "24m",
    "36m"
   ],
   "type": "string",
   "default": "",
   "description": "Show results in Zillow's selected time window; for sold properties this is the sold window."
  },
  "resultsLimit": {
   "type": "integer",
   "default": 100,
   "minimum": 0,
   "description": "Maximum unique listings per ZIP code across all selected categories. Zero means all accessible pages."
  },
  "forSaleByAgent": {
   "type": "boolean",
   "default": true,
   "description": "Include homes listed for sale by an agent."
  },
  "forSaleByOwner": {
   "type": "boolean",
   "default": false,
   "description": "Include owner-listed homes. Some ZIP codes have no matching listings."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "zpid": null,
    "homeType": null,
    "statusText": null,
    "propertyUrl": null,
    "listingStatus": null,
    "searchZipCode": null,
    "sourceSearchUrl": null,
    "providerListingId": null
   }
  ],
  "product": "zillow-search"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/zillow-property-search-api-x402-59cc4b16/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)