Skip to main content
POST
Search homes for sale, for rent or sold
  • Endpoint: zillow.search
  • Returns: data has listings, total.
  • Cost: 3 credits per 41 items, at least 3 credits. Failed calls cost nothing.
  • Paging: Yes. Send the cursor from the response to get the next page. See Paging.

Example

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
location
string
Required string length: 2 - 200
bounds
object
status
enum<string>
default:forSale
Available options:
forSale,
forRent,
sold
sort
enum<string>
default:relevance
Available options:
relevance,
newest,
priceHigh,
priceLow,
bedrooms,
bathrooms,
sqft,
lot
price
object
bedrooms
object
bathrooms
object
sqft
object
lotSqft
object
yearBuilt
object
hoa
object
homeTypes
enum<string>[]
Minimum array length: 1
Available options:
house,
townhouse,
multiFamily,
condo,
land,
apartment,
manufactured
listingTypes
enum<string>[]
Minimum array length: 1
Available options:
agent,
owner,
newConstruction,
comingSoon,
auction,
foreclosure
within
enum<string>
default:all
Available options:
day,
week,
twoWeeks,
month,
threeMonths,
sixMonths,
year,
twoYears,
threeYears,
all
query
string
Required string length: 1 - 200
features
enum<string>[]
Minimum array length: 1
Available options:
garage,
pool,
airConditioning,
waterfront,
singleStory,
openHouse,
tour3d,
cityView,
parkView,
waterView,
mountainView,
catsAllowed,
furnished
limit
integer
default:41
Required range: 1 <= x <= 410
cursor
string
Pattern: ^(?:\d{1,4}~(?:[2-9]|1\d|20)?|(?:[2-9]|1\d|20))$

Response

The data, and the credits this call used.

success
any
required
data
object
required
creditsUsed
integer
required
requestId
string
required