# Zillow API guide



## Start with Zillow



Find homes for sale and recently sold listings, then inspect property details. Apartment-building results show unit rents, mandatory fees and availability dates separately.



These requests use your API key and can spend credits. Check the current price on the endpoint page; each new page is a separate request. Later examples use illustrative identifiers: replace them with values from your earlier response.



### 1. Choose a location



Use the returned location display text for a search. [Parameters and current cost →](https://www.monocrawl.com/docs/endpoints/zillow/locations)



**zillow/locations**

```
curl "https://www.monocrawl.com/v1/zillow/locations?query=Austin%20TX" \
  -H "x-api-key: mn_your_key_here"
```



### 2. Find homes for sale



Keep the search filters unchanged when following its cursor. The service returns native result pages. [Parameters and current cost →](https://www.monocrawl.com/docs/endpoints/zillow/search-sale)



**zillow/search-sale**

```
curl "https://www.monocrawl.com/v1/zillow/search-sale?location=Austin%2C%20TX&max_price=600000&min_beds=3&sort=newest" \
  -H "x-api-key: mn_your_key_here"
```



### 3. Inspect a home



Use an id from search. Price history, tax history and school data are not supported. [Parameters and current cost →](https://www.monocrawl.com/docs/endpoints/zillow/property)



**zillow/property**

```
curl "https://www.monocrawl.com/v1/zillow/property?id=29479546" \
  -H "x-api-key: mn_your_key_here"
```



## Choose filters with the source behavior in mind



| Control | Behavior and limits |
| --- | --- |
| Search filters | location, min_price, max_price and min_beds constrain searches. Only newest sort is supported. Native pages can vary in size; use the returned cursor. [Endpoint reference →](https://www.monocrawl.com/docs/endpoints/zillow/search-sale) |
| Property detail | The available current listing fields do not include historical prices, tax history or school data. Optional estimates can be absent. [Endpoint reference →](https://www.monocrawl.com/docs/endpoints/zillow/property) |
| Rental unit meaning | Building records can include units available in the future. Compare available_from_at, base_rent and mandatory monthly fees; do not treat every unit as available now. [Endpoint reference →](https://www.monocrawl.com/docs/endpoints/zillow/building) |



Source availability, ordering and field coverage can change. Inspect warnings and partial-result metadata alongside the rows. See [runnable workflows](https://www.monocrawl.com/docs/workflows), [computed fields](https://www.monocrawl.com/docs/computed-fields) and [pagination and caching](https://www.monocrawl.com/docs/pagination-caching).



## Match the operation to your task



| Your task | Endpoint | When to use it |
| --- | --- | --- |
| Recently sold homes | [`search-sold`](https://www.monocrawl.com/docs/endpoints/zillow/search-sold) | Read displayed listing prices; these are not independently verified transaction values. |
| Apartment units | [`building`](https://www.monocrawl.com/docs/endpoints/zillow/building) | Use a Zillow apartment-building URL. Unit records may include future availability; compare required fees as well as base rent. |



Explore all documented operations by purpose below. Each endpoint reference contains its accepted parameters and current price.



### Other operations



- [`building`](https://www.monocrawl.com/docs/endpoints/zillow/building)

- [`locations`](https://www.monocrawl.com/docs/endpoints/zillow/locations)

- [`property`](https://www.monocrawl.com/docs/endpoints/zillow/property)



### Search and discovery



- [`search-sale`](https://www.monocrawl.com/docs/endpoints/zillow/search-sale)

- [`search-sold`](https://www.monocrawl.com/docs/endpoints/zillow/search-sold)



## Endpoint reference

## zillow/building

`GET /v1/zillow/building`

Building details and unit-level rents, beds, area, required fees and availability dates. Records can include future availability; base rent and mandatory fees remain separate.

*Zillow building and units*

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Zillow apartment-building page URL. — e.g. `https://www.zillow.com/apartments/austin-tx/alexan-st.-elmo/C8gzfc/` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. — e.g. `1` |

**Cost:** 1 credit at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/zillow/building?url=https%3A%2F%2Fwww.zillow.com%2Fapartments%2Faustin-tx%2Falexan-st.-elmo%2FC8gzfc%2F" \
  -H "x-api-key: mn_your_key_here"
```


## zillow/locations

`GET /v1/zillow/locations`

Location suggestions for property searches.

*Zillow location suggestions*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Location text. — e.g. `Austin TX` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. — e.g. `1` |

**Cost:** 1 credit at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/zillow/locations?query=Austin%20TX" \
  -H "x-api-key: mn_your_key_here"
```


## zillow/property

`GET /v1/zillow/property`

Property listing price, photos, description, basic facts and optional estimated values. Historical prices, tax history and school data are not supported.

*Zillow property*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | Numeric identifier from a parent result. — e.g. `29479546` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. — e.g. `1` |

**Cost:** 1 credit at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/zillow/property?id=29479546" \
  -H "x-api-key: mn_your_key_here"
```


## zillow/search-sale

`GET /v1/zillow/search-sale`

Homes for sale with listing prices, photos, bedrooms, bathrooms, address and coordinates where supplied. Native result pages use an opaque cursor.

*Zillow homes for sale*

| Parameter | Required | Description |
| --- | --- | --- |
| `location` | yes | City/region in the United States or Canada. — e.g. `Austin, TX` |
| `min_price` | no | Minimum listing price. |
| `max_price` | no | Maximum listing price. — e.g. `600000` |
| `min_beds` | no | Minimum bedrooms. — e.g. `3` |
| `sort` | no | Newest listings first. Only newest is supported. — e.g. `newest` |
| `cursor` | no | Opaque continuation from this operation; preserve all original parameters. |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. — e.g. `1` |

**Cost:** 1 credit at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/zillow/search-sale?location=Austin%2C%20TX" \
  -H "x-api-key: mn_your_key_here"
```


## zillow/search-sold

`GET /v1/zillow/search-sold`

Recently sold property listings and their displayed prices. This is a listing search, not a price-history or transaction-verification service.

*Zillow recently sold homes*

| Parameter | Required | Description |
| --- | --- | --- |
| `location` | yes | City/region in the United States or Canada. — e.g. `Austin, TX` |
| `min_price` | no | Minimum listing price. |
| `max_price` | no | Maximum listing price. — e.g. `600000` |
| `min_beds` | no | Minimum bedrooms. — e.g. `3` |
| `sort` | no | Newest listings first. Only newest is supported. — e.g. `newest` |
| `cursor` | no | Opaque continuation from this operation; preserve all original parameters. |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. — e.g. `1` |

**Cost:** 1 credit at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/zillow/search-sold?location=Austin%2C%20TX" \
  -H "x-api-key: mn_your_key_here"
```