Skip to main content
GET
Search Properties

Query Parameters

location
string
required
Free-text location: a city (“Austin, TX”), a ZIP, an address, or a neighborhood.
status
string
default:"for_sale"
Listing status filter.
page
integer
default:1
Page number for paginated results. Zillow caps search at 20 pages (~820 results). Range: 1 - 20.
sort
string
Sort order for results.
price_min
integer
Minimum price in USD.
price_max
integer
Maximum price in USD.
beds_min
integer
Minimum number of bedrooms. Range: 0 - 10.
baths_min
number
Minimum number of bathrooms. Range: 0 - 10.
home_type
string
Comma-separated list of home types.Values: houses, condos, townhomes, apartments, manufactured, lots, multi_family.
sqft_min
integer
Minimum interior square footage.
sqft_max
integer
Maximum interior square footage.
lot_min
integer
Minimum lot size in square feet.
lot_max
integer
Maximum lot size in square feet.
year_built_min
integer
Earliest year built.
year_built_max
integer
Latest year built.
hoa_max
integer
Maximum monthly HOA fee.
keywords
string
Match listing-description keywords.
days_on
string
Days-on-Zillow filter (e.g. 1, 7, 30).
north
number
North latitude of a map-bounds box. Power-user option for tiling past the ~820-result cap.
south
number
South latitude of a map-bounds box.
east
number
East longitude of a map-bounds box.
west
number
West longitude of a map-bounds box.

Response

location
string
The location that was searched.
status
string
The status filter that was applied (for_sale, for_rent, sold).
map_results_count
integer
Total number of listings Zillow reports inside the map bounds (may exceed the page cap).
region
object
The resolved region: region_id and region_type. Re-use region_id to tile or refine searches.
map_bounds
object
The map bounding box the search covers: north, east, south, west. Subdivide this to beat the 820-result cap.
pagination
object
Page-number pagination: current_page, per_page, total_pages, total_results.
scraped_utc
number
Scrape time as a Unix timestamp (nullable).
scraped_at
string
Scrape time as an ISO-8601 string (nullable).
results
array
Array of matching listing cards.

Example Response

Each search request costs 5 credits. Failed requests are not charged.

Authorizations

x-api-key
string
header
required

Query Parameters

location
string
required

City/state, ZIP, address, or neighborhood (e.g. 'Austin, TX').

status
enum<string>
default:for_sale

Listing status filter.

Available options:
for_sale,
for_rent,
sold
page
integer
default:1

Page number. Zillow caps search at 20 pages (~820 results).

Required range: 1 <= x <= 20
sort
enum<string>

Sort order for results.

Available options:
homes_for_you,
newest,
price_high_to_low,
price_low_to_high,
bedrooms,
bathrooms,
square_feet,
lot_size,
year_built
price_min
integer

Minimum price (USD).

Required range: x >= 0
price_max
integer

Maximum price (USD).

Required range: x >= 0
beds_min
integer

Minimum number of bedrooms.

Required range: 0 <= x <= 10
baths_min
number

Minimum number of bathrooms.

Required range: 0 <= x <= 10
home_type
enum<string>

Comma-separated home types.

Available options:
houses,
condos,
townhomes,
apartments,
manufactured,
lots,
multi_family
sqft_min
integer

Minimum interior square footage.

Required range: x >= 0
sqft_max
integer

Maximum interior square footage.

Required range: x >= 0
lot_min
integer

Minimum lot size in square feet.

Required range: x >= 0
lot_max
integer

Maximum lot size in square feet.

Required range: x >= 0
year_built_min
integer

Earliest year built.

Required range: x >= 1800
year_built_max
integer

Latest year built.

Required range: x >= 1800
hoa_max
integer

Maximum monthly HOA fee.

Required range: x >= 0
keywords
string

Match listing-description keywords.

days_on
string

Days-on-Zillow filter (e.g. '1', '7', '30').

north
number

North latitude of a map-bounds box (tile past the 820-result cap).

south
number

South latitude of a map-bounds box.

east
number

East longitude of a map-bounds box.

west
number

West longitude of a map-bounds box.

Response

200 - application/json

Matching listings

location
string | null
status
string
results
object[]
map_results_count
integer
region
object
map_bounds
object

The map bounding box a search covers — callers tile with this to beat Zillow's ~820-result (20-page) cap by subdividing dense boxes.

pagination
object

Page-number pagination (Zillow search returns ~40 results per page).

scraped_utc
number | null
scraped_at
string | null