> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Zillow Listings API

> Zillow property listings with ZPID and full address. Search by location or home type.

`POST /v1/data/zillow/listings/run`

**Pricing:** $0.002 per listing ($2.00 per 1,000).

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**location** `string` *required*

Location.

**listingType** `string` (default: forSale)

Listing Type to use. For sale by default.

Allowed values: `forSale` (For sale), `forRent` (For rent), `sold` (Recently sold).

**priceMin** `integer`

Price Min as a whole number.

Min `0`.

**priceMax** `integer`

Price Max as a whole number.

Min `0`.

**minBedrooms** `integer`

Min Bedrooms as a whole number.

Min `0`; max `20`.

**homeTypes** `string[]`

Only these home types. Leave empty for all types.

Allowed values: `house` (Houses), `condo` (Condos), `townhouse` (Townhomes), `multiFamily` (Multi-family), `apartment` (Apartments), `lot` (Lots / land), `manufactured` (Manufactured).

**maxResults** `integer` (default: 100)

How many listings to return in total. Defaults to 100; use 0 for all.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/zillow/listings/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "location": "Austin, TX",
    "listingType": "forSale",
    "maxResults": 10
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/zillow/listings/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "location": "Austin, TX",
    "listingType": "forSale",
    "maxResults": 10
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/zillow/listings/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "location": "Austin, TX",
  "listingType": "forSale",
  "maxResults": 10
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one listing, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `listingUrl` | Listing URL | url |
| `zpid` | Zpid | text |
| `address` | Address | text |
| `street` | Street | text |
| `city` | City | text |
| `state` | State | text |
| `zipCode` | Zip Code | text |
| `latitude` | Latitude | number |
| `longitude` | Longitude | number |
| `listingType` | Listing Type | text |
| `status` | Status | text |
| `statusText` | Status Text | text |
| `homeType` | Home Type | text |
| `isBuilding` | Is Building | boolean |
| `price` | Price | number |
| `beds` | Beds | number |
| `baths` | Baths | number |
| `sqft` | Sqft | number |
| `lotSizeSqft` | Lot Size Sqft | number |
| `daysOnZillow` | Days On Zillow | number |
| `zestimate` | Zestimate | number |
| `rentZestimate` | Rent Zestimate | number |
| `taxAssessedValue` | Tax Assessed Value | number |
| `brokerName` | Broker Name | text |
| `isFsbo` | Is Fsbo | boolean |
| `isNewConstruction` | Is New Construction | boolean |
| `isForeclosure` | Is Foreclosure | boolean |
| `isAuction` | Is Auction | boolean |
| `isComingSoon` | Is Coming Soon | boolean |
| `isOpenHouse` | Is Open House | boolean |
| `imageUrl` | Image URL | url |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "zillow/listings",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "homeType": "house",
      "isOpenHouse": false,
      "statusText": "House for sale",
      "city": "Austin",
      "baths": 4,
      "isAuction": false,
      "zpid": "111370909",
      "beds": 4,
      "zestimate": 1663100,
      "zipCode": "78732",
      "isComingSoon": false,
      "daysOnZillow": 3,
      "sqft": 4313,
      "lotSizeSqft": 21344,
      "longitude": -97.91205,
      "rentZestimate": 6417,
      "status": "FOR_SALE",
      "taxAssessedValue": 1261559,
      "brokerName": null,
      "state": "TX",
      "isForeclosure": false,
      "imageUrl": "https://photos.zillowstatic.com/fp/95cad77fb3c828e88b90409eebbbd399-p_e.jpg",
      "latitude": 30.33965,
      "street": "529 Summer Alcove Way",
      "listingUrl": "https://www.zillow.com/homedetails/529-Summer-Alcove-Way-Austin-TX-78732/111370909_zpid/"
    }
  ]
}
```

## Related APIs

For agents use [`zillow/agents`](https://docs.mindcase.co/apis/zillow/agents); for Redfin use [`redfin/listings`](https://docs.mindcase.co/apis/redfin/listings).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.