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

# Zillow ZIP Search

> Extract Zillow real estate property listings by ZIP code, specifying if for sale, rent, or sold

`$1 / 1k results`

Extract Zillow real estate property listings by ZIP code, specifying if for sale, rent, or sold

## Endpoint

`POST /api/v1/agents/zillow/zip-search/run`

## Parameters

<ParamField body="zipCodes" type="array" required>
  **List** · Zip codes to search properties in. One per line.
</ParamField>

<ParamField body="listingStatus" type="array" default={["agent"]}>
  **Multi-select** · Which listing types to include. Pick one or more.

  **Options:** `agent`, `owner`, `rent`, `sold`

  *Legend: `agent` = For sale (by agent), `owner` = For sale (by owner), `rent` = For rent, `sold` = Recently sold*
</ParamField>

<ParamField body="priceMin" type="integer">
  **Number** · Minimum price of property (monthly price for rental)
</ParamField>

<ParamField body="priceMax" type="integer">
  **Number** · Maximum price of property (monthly price for rental)
</ParamField>

<ParamField body="daysOnZillow" type="string" default="">
  **Dropdown** · Number of days a property has been listed on Zillow (if searching for Recently Sold, then this is the number of days since the property was sold)

  <Accordion title="Show all 9 options">
    `1`, `7`, `14`, `30`, `90`, `6m`, `12m`, `24m`, `36m`

    [View all 9 as a structured list →](/agents/zillow/zip-search/values#daysonzillow)
  </Accordion>
</ParamField>

<ParamField body="maxResults" type="integer" default={100}>
  **Number** · Maximum total properties to return across all zip codes.
</ParamField>

## Response columns

| Field                  | Display name           | Type     |
| ---------------------- | ---------------------- | -------- |
| `zip`                  | Zip                    | text     |
| `listingUrl`           | Listing URL            | url      |
| `image`                | Image                  | url      |
| `address`              | Address                | text     |
| `street`               | Street                 | text     |
| `city`                 | City                   | text     |
| `state`                | State                  | text     |
| `price`                | Price                  | text     |
| `priceRaw`             | Price (Raw)            | currency |
| `currency`             | Currency               | text     |
| `beds`                 | Beds                   | number   |
| `baths`                | Baths                  | number   |
| `areaSqft`             | Area (sqft)            | number   |
| `status`               | Status                 | text     |
| `statusType`           | Status Type            | text     |
| `marketingStatus`      | Marketing Status       | text     |
| `rawStatus`            | Raw Status             | text     |
| `homeType`             | Home Type              | text     |
| `homeStatus`           | Home Status            | text     |
| `daysOnZillow`         | Days On Zillow         | number   |
| `zestimate`            | Zestimate              | currency |
| `rentZestimate`        | Rent Zestimate         | currency |
| `taxAssessedValue`     | Tax Assessed Value     | currency |
| `priceChange`          | Price Change           | currency |
| `priceReduction`       | Price Reduction        | text     |
| `datePriceChanged`     | Date Price Changed     | text     |
| `livingArea`           | Living Area            | number   |
| `bedrooms`             | Bedrooms               | number   |
| `bathrooms`            | Bathrooms              | number   |
| `unit`                 | Unit                   | text     |
| `latitude`             | Latitude               | number   |
| `longitude`            | Longitude              | number   |
| `openHouse`            | Open House             | boolean  |
| `openHouseDescription` | Open House Description | text     |
| `openHouseStart`       | Open House Start       | text     |
| `openHouseEnd`         | Open House End         | text     |
| `3dModel`              | 3D Model               | boolean  |
| `hasImage`             | Has Image              | boolean  |
| `hasVideo`             | Has Video              | boolean  |
| `featured`             | Featured               | boolean  |
| `showcaseListing`      | Showcase Listing       | boolean  |
| `homeRec`              | Home Rec               | boolean  |
| `ownerClaiming`        | Owner Claiming         | boolean  |
| `ownerConfirmed`       | Owner Confirmed        | boolean  |
| `paidBuilderNew`       | Paid Builder New       | boolean  |
| `addressHidden`        | Address Hidden         | boolean  |
| `zillowOwned`          | Zillow Owned           | boolean  |
| `saved`                | Saved                  | boolean  |
| `infoLine`             | Info Line              | text     |
| `flexText`             | Flex Text              | text     |
| `contentType`          | Content Type           | text     |

## Example

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://api.mindcase.co/api/v1/agents/zillow/zip-search/run \
    -H "Authorization: Bearer mk_live_abc123def456" \
    -H "Content-Type: application/json" \
    -d '{
    "params": {
      "zipCodes": [
        "10014",
        "07306"
      ],
      "priceMax": 400000,
      "forRent": false,
      "forSaleByAgent": true,
      "sold": false,
      "forSaleByOwner": false
    }
  }'
  ```

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

  resp = requests.post(
      "https://api.mindcase.co/api/v1/agents/zillow/zip-search/run",
      headers={"Authorization": "Bearer mk_live_abc123def456"},
      json={"params": {
      "zipCodes": [
          "10014",
          "07306"
      ],
      "priceMax": 400000,
      "forRent": false,
      "forSaleByAgent": true,
      "sold": false,
      "forSaleByOwner": false
  }},
  )
  data = resp.json()
  ```
</CodeGroup>

### Example response

```json Response theme={null}
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "zip": "07306",
      "listingUrl": "https://www.zillow.com/homedetails/108-Waldo-Ave-APT-1D-Jersey-City-NJ-07306/2079175653_zpid/",
      "image": "https://photos.zillowstatic.com/fp/e1e71ecc6edd4b8b25d35e49b92ba0fe-p_e.jpg",
      "address": "108 Waldo Ave APT 1D, Jersey City, NJ 07306",
      "street": "108 Waldo Ave APT 1D",
      "city": "Jersey City",
      "state": "NJ",
      "price": "$319,000",
      "priceRaw": 319000,
      "currency": "$",
      "beds": 2,
      "baths": 1,
      "areaSqft": 0,
      "status": "Condo for sale",
      "statusType": "FOR_SALE",
      "marketingStatus": "For Sale by Agent",
      "rawStatus": "ForSale",
      "homeType": "CONDO",
      "homeStatus": "FOR_SALE",
      "daysOnZillow": 247,
      "zestimate": 311400,
      "rentZestimate": 2655,
      "taxAssessedValue": null,
      "priceChange": null,
      "priceReduction": null,
      "datePriceChanged": null,
      "livingArea": 0,
      "bedrooms": 2,
      "bathrooms": 1,
      "unit": "Apt 1D",
      "latitude": 40.72812,
      "longitude": -74.05508,
      "openHouse": null,
      "openHouseDescription": null,
      "openHouseStart": null,
      "openHouseEnd": null,
      "3dModel": false,
      "hasImage": true,
      "hasVideo": false,
      "featured": false,
      "showcaseListing": false,
      "homeRec": false,
      "ownerClaiming": false,
      "ownerConfirmed": false,
      "paidBuilderNew": false,
      "addressHidden": false,
      "zillowOwned": false,
      "saved": false,
      "infoLine": "Listing provided by HCMLS",
      "flexText": "Hardwood floors throughout",
      "contentType": "homeInsight"
    }
  ]
}
```