# Zillow · Search

Search property, job and marketplace listings with Zillow · Search from Alexandria through one Spiral API key. Find for-sale listings in a region or a map box. Chain from locations: pass its region_id (or region_ids[0]) as region_id and its region_types[0] / region_subtype as region_type; bounds are then optional and the response's pages[].region.bounds carries the region's box for map or a narrower search. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: Listings
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `zillow-com/properties/search`
- Page: https://spiral.ai/tools/alexandria/zillow-com/properties/search

## Pricing

$0.00873 per call.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 5 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `page` | number | 1 to 20 | 1 | page |
| `zoom` | number | 1 to 20 | 11 | zoom |
| `pages` | number | 1 to 3 | 1 | pages |
| `bounds` | JSON |  | — | Map bounding box {west, east, south, north} in longitude/latitude degrees, west < east and south < north, at most 10 degrees per axis. Optional when region_id is given: the search then covers the whole region and returns its box in pages[].region.bounds. |
| `region_id` | number | 1 to 4294967295 | — | Zillow region identifier: a locations result's region_id or region_ids[0]. Sufficient on its own; with bounds it narrows the box to the region. |
| `include_map` | true or false |  | — | include_map |
| `region_type` | one of | 2, 4, 6, 7, 8 | 6 | Region type as the numeric Zillow code (2 state, 4 county, 6 city, 7 zipcode, 8 neighborhood) or the matching region_types / region_subtype string returned by locations. Only pass with region_id. |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "zillow-com/properties/search",
    "input": {
      "bounds": {}
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=zillow-com%2Fproperties%2Fsearch

## Common questions

### Zillow · Search

**How much does Zillow · Search cost?**

$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use Zillow · Search through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "zillow-com/properties/search"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with Alexandria to use Zillow · Search?**

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

**Can my AI agent use Zillow · Search?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

