---
title: "Search Properties"
method: GET
path: "/v1/zillow/search"
tags: ["Zillow Search"]
---

# Search Properties

`GET /v1/zillow/search`

Search Zillow for for-sale / for-rent / sold listings with rich filters.

## Query parameters

- `location` string, required
- `status` 'for_sale' | 'for_rent' | 'sold'
- `page` integer
- `sort` 'homes_for_you' | 'newest' | 'price_high_to_low' | 'price_low_to_high' | 'bedrooms' | 'bathrooms' | 'square_feet' | 'lot_size' | 'year_built'
- `price_min` integer
- `price_max` integer
- `beds_min` integer
- `baths_min` number
- `home_type` 'houses' | 'condos' | 'townhomes' | 'apartments' | 'manufactured' | 'lots' | 'multi_family'
- `sqft_min` integer
- `sqft_max` integer
- `lot_min` integer
- `lot_max` integer
- `year_built_min` integer
- `year_built_max` integer
- `hoa_max` integer
- `keywords` string
- `days_on` string
- `north` number
- `south` number
- `east` number
- `west` number

## Response `200`

Matching listings

- object
  - `location` string, nullable
  - `status` string
  - `results` Listing[]
    - `position` integer, required
    - `zpid` string, nullable
    - `id` string, nullable
    - `detail_url` string, nullable
    - `home_type` string, nullable
    - `home_status` string, nullable
    - `status_text` string, nullable
    - `status_type` string, nullable
    - `marketing_status` string, nullable
    - `contingent_listing_type` string, nullable
    - `price` integer, nullable
    - `price_raw` string, nullable
    - `currency` string, nullable
    - `price_change` integer, nullable
    - `date_price_changed_utc` number, nullable
    - `date_price_changed_at` string, nullable
    - `price_reduction` string, nullable
    - `flex_field_text` string, nullable
    - `zestimate` integer, nullable
    - `rent_zestimate` integer, nullable
    - `tax_assessed_value` integer, nullable
    - `beds` number, nullable
    - `baths` number, nullable
    - `living_area` integer, nullable
    - `lot_area_value` number, nullable
    - `lot_area_unit` string, nullable
    - `address` string, nullable
    - `street_address` string, nullable
    - `unit` string, nullable
    - `city` string, nullable
    - `state` string, nullable
    - `zipcode` string, nullable
    - `country` string, nullable
    - `is_undisclosed_address` boolean, nullable
    - `latitude` number, nullable
    - `longitude` number, nullable
    - `broker_name` string, nullable
    - `provider_listing_id` string, nullable
    - `days_on_zillow` integer, nullable
    - `is_zillow_owned` boolean, nullable
    - `is_featured` boolean, nullable
    - `is_showcase` boolean, nullable
    - `is_fsba` boolean, nullable
    - `is_new_construction` boolean, nullable
    - `is_premier_builder` boolean, nullable
    - `is_preforeclosure_auction` boolean, nullable
    - `is_non_owner_occupied` boolean, nullable
    - `img_src` string, nullable
    - `has_image` boolean, nullable
    - `has_video` boolean, nullable
    - `has_3d_model` boolean, nullable
    - `has_open_house` boolean, nullable
    - `open_house_start` string, nullable
    - `open_house_end` string, nullable
    - `photos` string[]
  - `map_results_count` integer
  - `region` RegionSelection
    - `region_id` integer, nullable
    - `region_type` integer, nullable
  - `map_bounds` MapBounds — The map bounding box a search covers — callers tile with this to beat Zillow's ~820-result (20-page) cap by subdividing dense boxes.
    - `north` number, nullable
    - `east` number, nullable
    - `south` number, nullable
    - `west` number, nullable
  - `pagination` Pagination — Pagination metadata.
    - `current` union
      - integer
      - string
    - `next` string, nullable
    - `total_results` integer, nullable
    - `total_pages` integer, nullable
    - `page_no` object
  - `scraped_utc` number, nullable
  - `scraped_at` string, nullable

---

[API](https://skmtc.net/scrapebadger/apis/scrapebadger-account-api.md) · [All operations](https://skmtc.net/scrapebadger/apis/scrapebadger-account-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scrapebadger/scrapebadger-account-api/revisions/4a1ef8777baf/schema)