Search Properties

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

GET /v1/zillow/search

Search Properties

cURL

curl --request GET \
  --url https://scrapebadger.com/v1/zillow/search \
  --header 'x-api-key: <api-key>'

200

{
  "location": "<string>",
  "status": "<string>",
  "results": [
    {
      "position": 123,
      "zpid": "<string>",
      "id": "<string>",
      "detail_url": "<string>",
      "home_type": "<string>",
      "home_status": "<string>",
      "status_text": "<string>",
      "status_type": "<string>",
      "marketing_status": "<string>",
      "contingent_listing_type": "<string>",
      "price": 123,
      "price_raw": "<string>",
      "currency": "<string>",
      "price_change": 123,
      "date_price_changed_utc": 123,
      "date_price_changed_at": "<string>",
      "price_reduction": "<string>",
      "flex_field_text": "<string>",
      "zestimate": 123,
      "rent_zestimate": 123,
      "tax_assessed_value": 123,
      "beds": 123,
      "baths": 123,
      "living_area": 123,
      "lot_area_value": 123,
      "lot_area_unit": "<string>",
      "address": "<string>",
      "street_address": "<string>",
      "unit": "<string>",
      "city": "<string>",
      "state": "<string>",
      "zipcode": "<string>",
      "country": "<string>",
      "is_undisclosed_address": true,
      "latitude": 123,
      "longitude": 123,
      "broker_name": "<string>",
      "provider_listing_id": "<string>",
      "days_on_zillow": 123,
      "is_zillow_owned": true,
      "is_featured": true,
      "is_showcase": true,
      "is_fsba": true,
      "is_new_construction": true,
      "is_premier_builder": true,
      "is_preforeclosure_auction": true,
      "is_non_owner_occupied": true,
      "img_src": "<string>",
      "has_image": true,
      "has_video": true,
      "has_3d_model": true,
      "has_open_house": true,
      "open_house_start": "<string>",
      "open_house_end": "<string>",
      "photos": [
        "<string>"
      ]
    }
  ],
  "map_results_count": 123,
  "region": {
    "region_id": 123,
    "region_type": 123
  },
  "map_bounds": {
    "north": 123,
    "east": 123,
    "south": 123,
    "west": 123
  },
  "pagination": {
    "current_page": 123,
    "per_page": 123,
    "total_pages": 123,
    "total_results": 123
  },
  "scraped_utc": 123,
  "scraped_at": "<string>"
}

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.

Value	Description
for_sale	Active for-sale listings (default)
for_rent	Rental listings
sold	Recently sold listings

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.

Value	Description
homes_for_you	Best match
newest	Most recently listed
price_high_to_low	Most expensive first
price_low_to_high	Cheapest first
bedrooms	By bedroom count
bathrooms	By bathroom count
square_feet	By interior area
lot_size	By lot size
year_built	By year built

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.

Show Listing object

position · integer

1-based position within the result set.

zpid · string

Zillow property id — pass to the property detail endpoint (nullable).

id · string

Internal listing id (nullable).

detail_url · string

Full URL to the listing (nullable).

home_type · string

Home type, e.g. SINGLE_FAMILY, CONDO, TOWNHOUSE, APARTMENT (nullable).

home_status · string

Home status, e.g. FOR_SALE, FOR_RENT, SOLD, PENDING (nullable).

status_text · string

Human status text, e.g. House for sale (nullable).

status_type · string

Status type (nullable).

marketing_status · string

Marketing status (nullable).

contingent_listing_type · string

Contingency type (nullable).

price · integer

Price in USD (nullable).

price_raw · string

Raw price string, e.g. $460,000 or $2,400/mo (nullable).

currency · string

ISO 4217 currency code (nullable).

price_change · integer

Signed price change amount (nullable).

date_price_changed_utc · number

Price-change date as a Unix timestamp (nullable).

date_price_changed_at · string

Price-change date as an ISO-8601 string (nullable).

price_reduction · string

Price-reduction label (nullable).

flex_field_text · string

Marketing badge text, e.g. Price cut (nullable).

zestimate · integer

Zillow value estimate (nullable).

rent_zestimate · integer

Zillow rent estimate (nullable).

tax_assessed_value · integer

Tax-assessed value (nullable).

beds · number

Number of bedrooms (nullable).

baths · number

Number of bathrooms (nullable).

living_area · integer

Interior square footage (nullable).

lot_area_value · number

Lot size value (nullable).

lot_area_unit · string

Lot size unit, e.g. sqft, acres (nullable).

address · string

Full one-line address (nullable).

street_address · string

Street line (nullable).

unit · string

Unit / apartment number (nullable).

city · string

City (nullable).

state · string

State code (nullable).

zipcode · string

ZIP code (nullable).

country · string

Country code (nullable).

is_undisclosed_address · boolean

Whether the address is withheld (nullable).

latitude · number

Latitude (nullable).

longitude · number

Longitude (nullable).

broker_name · string

Listing broker name (nullable).

provider_listing_id · string

Provider listing id (nullable).

days_on_zillow · integer

Days on Zillow (nullable).

is_zillow_owned · boolean

Whether Zillow owns the home (nullable).

is_featured · boolean

Featured listing flag (nullable).

is_showcase · boolean

Showcase listing flag (nullable).

is_fsba · boolean

For-sale-by-agent flag (nullable).

is_new_construction · boolean

New-construction flag (nullable).

is_premier_builder · boolean

Premier-builder flag (nullable).

is_preforeclosure_auction · boolean

Pre-foreclosure / auction flag (nullable).

is_non_owner_occupied · boolean

Non-owner-occupied flag (nullable).

img_src · string

Primary photo URL (nullable).

has_image · boolean

Whether the listing has photos (nullable).

has_video · boolean

Whether the listing has video (nullable).

has_3d_model · boolean

Whether the listing has a 3D model (nullable).

has_open_house · boolean

Whether an open house is scheduled (nullable).

open_house_start · string

Open-house start (nullable).

open_house_end · string

Open-house end (nullable).

photos · array

Additional photo URLs.

Example Response

{
  "location": "Austin, TX",
  "status": "for_sale",
  "map_results_count": 842,
  "region": { "region_id": 10221, "region_type": 6 },
  "map_bounds": { "north": 30.52, "east": -97.56, "south": 30.09, "west": -97.94 },
  "pagination": { "current_page": 1, "per_page": 40, "total_pages": 20, "total_results": 842 },
  "scraped_at": "2026-07-07T12:00:00Z",
  "results": [
    {
      "position": 1,
      "zpid": "29499726",
      "detail_url": "https://www.zillow.com/homedetails/123-Main-St-Austin-TX-78701/29499726_zpid/",
      "home_type": "SINGLE_FAMILY",
      "home_status": "FOR_SALE",
      "status_text": "House for sale",
      "price": 460000,
      "price_raw": "$460,000",
      "currency": "USD",
      "zestimate": 468000,
      "rent_zestimate": 2600,
      "beds": 3,
      "baths": 2,
      "living_area": 1800,
      "lot_area_value": 6500,
      "lot_area_unit": "sqft",
      "address": "123 Main St, Austin, TX 78701",
      "city": "Austin",
      "state": "TX",
      "zipcode": "78701",
      "latitude": 30.2672,
      "longitude": -97.7431,
      "days_on_zillow": 4,
      "is_fsba": true,
      "img_src": "https://photos.zillowstatic.com/fp/abc-p_e.jpg"
    }
  ]
}

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[]

Show child attributes

map_results_count · integer

region · object

Show child attributes

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.

Show child attributes

pagination · object

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

Show child attributes

scraped_utc · number | null

scraped_at · string | null