Search Properties

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

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://scrapebadger.com/v1/zillow/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://scrapebadger.com/v1/zillow/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://scrapebadger.com/v1/zillow/search"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://scrapebadger.com/v1/zillow/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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>"
}

GET

zillow

Search Properties

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

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://scrapebadger.com/v1/zillow/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://scrapebadger.com/v1/zillow/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://scrapebadger.com/v1/zillow/search"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://scrapebadger.com/v1/zillow/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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

string

required

Free-text location: a city (“Austin, TX”), a ZIP, an address, or a neighborhood.

string

default:"for_sale"

Listing status filter.

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

integer

default:1

Page number for paginated results. Zillow caps search at 20 pages (~820 results). Range: 1 - 20.

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

integer

Minimum price in USD.

integer

Maximum price in USD.

integer

Minimum number of bedrooms. Range: 0 - 10.

number

Minimum number of bathrooms. Range: 0 - 10.

string

Comma-separated list of home types.Values: houses, condos, townhomes, apartments, manufactured, lots, multi_family.

integer

Minimum interior square footage.

integer

Maximum interior square footage.

integer

Minimum lot size in square feet.

integer

Maximum lot size in square feet.

integer

Earliest year built.

integer

Latest year built.

integer

Maximum monthly HOA fee.

string

Match listing-description keywords.

string

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

number

North latitude of a map-bounds box. Power-user option for tiling past the ~820-result cap.

number

South latitude of a map-bounds box.

number

East longitude of a map-bounds box.

number

West longitude of a map-bounds box.

Response

string

The location that was searched.

string

The status filter that was applied (for_sale, for_rent, sold).

integer

Total number of listings Zillow reports inside the map bounds (may exceed the page cap).

object

The resolved region: region_id and region_type. Re-use region_id to tile or refine searches.

object

The map bounding box the search covers: north, east, south, west. Subdivide this to beat the 820-result cap.

object

Page-number pagination: current_page, per_page, total_pages, total_results.

number

Scrape time as a Unix timestamp (nullable).

string

Scrape time as an ISO-8601 string (nullable).

array

Array of matching listing cards.

Show Listing object

integer

1-based position within the result set.

string

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

string

Internal listing id (nullable).

string

Full URL to the listing (nullable).

string

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

string

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

string

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

string

Status type (nullable).

string

Marketing status (nullable).

string

Contingency type (nullable).

integer

Price in USD (nullable).

string

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

string

ISO 4217 currency code (nullable).

integer

Signed price change amount (nullable).

number

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

string

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

string

Price-reduction label (nullable).

string

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

integer

Zillow value estimate (nullable).

integer

Zillow rent estimate (nullable).

integer

Tax-assessed value (nullable).

number

Number of bedrooms (nullable).

number

Number of bathrooms (nullable).

integer

Interior square footage (nullable).

number

Lot size value (nullable).

string

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

string

Full one-line address (nullable).

string

Street line (nullable).

string

Unit / apartment number (nullable).

string

City (nullable).

string

State code (nullable).

string

ZIP code (nullable).

string

Country code (nullable).

boolean

Whether the address is withheld (nullable).

number

Latitude (nullable).

number

Longitude (nullable).

string

Listing broker name (nullable).

string

Provider listing id (nullable).

integer

Days on Zillow (nullable).

boolean

Whether Zillow owns the home (nullable).

boolean

Featured listing flag (nullable).

boolean

Showcase listing flag (nullable).

boolean

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

boolean

New-construction flag (nullable).

boolean

Premier-builder flag (nullable).

boolean

Pre-foreclosure / auction flag (nullable).

boolean

Non-owner-occupied flag (nullable).

string

Primary photo URL (nullable).

boolean

Whether the listing has photos (nullable).

boolean

Whether the listing has video (nullable).

boolean

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

boolean

Whether an open house is scheduled (nullable).

string

Open-house start (nullable).

string

Open-house end (nullable).

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

Overview

Search

Properties

Agents

Reference

Search Properties

Query Parameters

Response

Example Response

Authorizations

Query Parameters

Response

​Query Parameters

​Response

​Example Response

Authorizations

Query Parameters

Response

Query Parameters

Response

Example Response