---
title: "Search for properties on Zillow"
method: POST
path: "/zillow/search-properties"
tags: ["Zillow"]
---

# Search for properties on Zillow

`POST /zillow/search-properties`

Search for properties on Zillow for a given location, listing status, and other criteria

## Request body

- object
  - `location` string, required — The location to search for properties
  - `listing_status` 'for_sale' | 'for_rent' | 'sold', required — The status of the listings (e.g., "for_sale", "for_rent")
  - `sort_by` 'homes_for_you' | 'rental_priority_score' | 'price_high_to_low' | 'price_low_to_high' | 'newest' | 'bedrooms' | 'bathrooms' | 'square_feet' | 'lot_size' | 'year_built' — The criteria to sort the results (e.g., "newest", "lot_size")
  - `page` integer — The page number of results to retrieve
  - `min_listing_price` number — The minimum listing price for the properties
  - `max_listing_price` number — The maximum listing price for the properties
  - `min_num_bedrooms` 'any' | 'studio' | '1' | '2' | '3' | '4' | '5' — The minimum number of bedrooms
  - `max_num_bedrooms` 'any' | 'studio' | '1' | '2' | '3' | '4' | '5' — The maximum number of bedrooms

## Response `200`

SearchProperties API successful response

- object
  - `properties` ZillowProperty[]
    - `property_id` integer — Unique identifier for the property
    - `address` object — The physical address of the property
      - `streetAddress` string — The street address of the building
      - `zipcode` string — The zipcode of the building
      - `city` string — The city of the building
      - `state` string — The state of the building
      - `buildingId` integer — The ID of the building
    - `photos` string[] — List of photo URLs for the property
    - `bathrooms` number, float, nullable — Number of bathrooms in the property
    - `bedrooms` integer, nullable — Number of bedrooms in the property
    - `living_area` number, float, nullable — The living area of the property in square feet
    - `year_built` integer, nullable — The year the property was built
    - `property_type` string — Type of the property (e.g. house, condo)
    - `listing_status` string — Status of the listing (e.g. forSale, sold)
    - `days_on_zillow` integer, nullable — Number of days the property has been listed on Zillow
    - `price` number, float — Listing price of the property
    - `zestimate` number, float, nullable — Zillow's estimated value of the property
    - `rent_zestimate` number, float, nullable — Zillow's estimated value of the rent for the property
    - `price_history` ZillowPriceHistoryEvent[]
      - `date_posted` string — The date of the price change
      - `price` number, float, nullable — The price of the property at the given date
      - `time_epoch` integer — Time of the price change in epoch format
      - `price_per_square_foot` number, float, nullable — Price per square foot at the given date
      - `price_change_rate` number, float — Rate of change in price over time
      - `event` string — Description of the event (e.g., price increase, price decrease)
      - `source` string — Source of the price history data
      - `is_rental` boolean — Indicates if the property is a rental

## Other responses

- `400` — User error response
- `500` — Server error response

---

[API](https://skmtc.net/carvedai/apis/exfunc-apis.md) · [All operations](https://skmtc.net/carvedai/apis/exfunc-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carvedai/exfunc-apis/revisions/22587fdf9a5e/schema)