API illustration

Zillow API Network

GetDeepSearch-Results API

The GetDeepSearchResults API finds a property for a specified address. The result set returned contains the full address(s), zpid and Zestimate data that is provided by the GetSearchResults API. Moreover, this API call also gives rich property data like lot size, year built, bath/beds, last sale details etc.

The GetSearchResults API Web Service is located at: http://www.zillow.com/webservice/GetDeepSearchResults.htm

The parameters of the API are:

ParameterDescriptionRequired
zws-idThe Zillow Web Service Identifier. Each subscriber to Zillow Web Services is uniquely identified by an ID sequence and every request to Web services requires this ID. Click here to get yours.Yes
addressThe address of the property to search. This string should be URL encoded.Yes
citystatezipThe city+state combination and/or ZIP code for which to search. This string should be URL encoded. Note that giving both city and state is required. Using just one will not work.Yes
rentzestimateReturn Rent Zestimate information if available (boolean true/false, default: false)No

The API result set:

ParameterDescription
zpidThe Zillow Property ID. Other API calls use this zpid to identify properties, and to retrieve property-specific data.
Links URLs to specific Zillow pages for this property:
  • Home details page
  • Chart data page
  • Map this home page
  • Similar sales page
Full address The complete address for the property:
  • Street address
  • ZIP code
  • City
  • State
  • Latitude
  • Longitude
Zestimate data Zestimate related data:
  • Zestimate (in $)
  • Last updated
  • 30-day change (in $)
  • Valuation range (high) (in $)
  • Valuation range (low) (in $)
  • Percentile (?)
Rent Zestimate data Rent Zestimate related data:
  • Rent Zestimate (in $)
  • Last updated
  • 30-day change (in $)
  • Valuation range (high) (in $)
  • Valuation range (low) (in $)
Local real estate Real estate data for neighborhood, city, and State
  • Zillow Home Value Index
  • Zillow Home Value Index 1-Yr change
  • Link to Region overview Page
  • Link to For Sale by Owner homes page.
  • Link to for sale homes page.
FIPScountyThe FIPS county code is a five-digit Federal Information Processing Standard (FIPS) code (FIPS 6-4) which uniquely identifies counties and county equivalents in the United States, certain U.S. possessions, and certain freely associated states. The first two digits are the FIPS state code and the last three are the county code within the state or possession.
Usecode This code specifies the type of home. The list of codes and the type of home they stand for are given below:
  1. Unknown
  2. SingleFamily
  3. Duplex
  4. Triplex
  5. Quadruplex
  6. Condominium
  7. Cooperative
  8. Mobile
  9. MultiFamily2To4
  10. MultiFamily5Plus
  11. Timeshare
  12. Miscellaneous
  13. VacantResidentialLand
Tax assessment yearThe year of the most recent tax assessment
Tax assessmentThe most recent tax assessment
YearbuiltThe year in which the property was constructed.
lotsizeSqFtThe size of the lot in sq. ft.
finishedSqFtThe size of the finished property in sq. ft.
BathroomsNumber of bathrooms in the property.
BedroomsNumber of bedrooms in the property.
LastSoldDateThe date of last sale for this property.
LastSoldPriceThe price of the last sale for this property.
Limit-warning If this field is set to "true", it means you are approaching your call limit. It appears under the 'message' element in the API result set:
<message>
<text>Request successfully processed</text>
<code>0</code>
<limit-warning>true</limit-warning>
</message>
This output field will not be returned if it is false.

Messages and Codes

The following table summarizes possible return codes from the API:

Error codeDescriptionResolution
0Request successfully processed
1Service error-there was a server-side error while processing the requestCheck to see if your url is properly formed: delimiters, character cases, etc
2The specified ZWSID parameter was invalid or not specified in the requestCheck if you have provided a ZWSID in your API call. If yes, check if the ZWSID is keyed in correctly. If it still doesn't work, contact Zillow to get help on fixing your ZWSID.
3Web services are currently unavailable The Zillow Web Service is currently not available. Please come back later and try again.
4The API call is currently unavailableThe Zillow Web Service is currently not available. Please come back later and try again.
500Invalid or missing address parameterCheck if the input address parameter matches the format specified in the input parameters table. When inputting a city name, the state should also be given. A city name alone will not give a valid address.
501Invalid or missing citystatezip parameterSame as error 500.
502No results foundSorry, the address you provided is not found in the Zillow property database.
503Failed to resolve city, state or ZIP codeCheck if the city-state combination is valid. Also check if you have provided a valid ZIP code.
504No coverage for specified areaThe specified area is not covered by the Zillow property database. To see our property coverage tables, click here.
505TimeoutYour request timed out. The server could be busy or unavailable. Try again later.
506Address string too longIf address is valid, try using abbreviations.
507No exact match found.Verify that the given address is correct.

Sample Calls

Below is an example of calling the API for the address for the exact address match "2114 Bigelow Ave", "Seattle, WA":
http://www.zillow.com/webservice/GetDeepSearchResults.htm?zws-id=<ZWSID>&address=2114+Bigelow+Ave&citystatezip=Seattle%2C+WA

Sample API Output

<SearchResults:searchresults xsi:schemaLocation="http://www.zillow.com/static/xsd/SearchResults.xsd /vstatic/ae1bf8a790b67ef2e902d2bc04046f02/static/xsd/SearchResults.xsd">
<request>
<address>2114 Bigelow Ave</address>
<citystatezip>Seattle, WA</citystatezip>
</request>
<message>
<text>Request successfully processed</text>
<code>0</code>
</message>
<response>
<results>
<result>
<zpid>48749425</zpid>
<links>
<homedetails>
http://www.zillow.com/homedetails/2114-Bigelow-Ave-N-Seattle-WA-98109/48749425_zpid/
</homedetails>
<graphsanddata>
http://www.zillow.com/homedetails/charts/48749425_zpid,1year_chartDuration/?cbt=8224687894635748395%7E7%7EjS-H-hFDCRzaVl6bMy4IjMErWd4OhP23IK8vmp4_m9u_SO1ruBhoCA**
</graphsanddata>
<mapthishome>http://www.zillow.com/homes/map/48749425_zpid/</mapthishome>
<comparables>http://www.zillow.com/homes/comps/48749425_zpid/</comparables>
</links>
<address>
<street>2114 Bigelow Ave N</street>
<zipcode>98109</zipcode>
<city>Seattle</city>
<state>WA</state>
<latitude>47.63793</latitude>
<longitude>-122.347936</longitude>
</address>
<FIPScounty>33</FIPScounty>
<useCode>SingleFamily</useCode>
<taxAssessmentYear>2008</taxAssessmentYear>
<taxAssessment>1054000.0</taxAssessment>
<yearBuilt>1924</yearBuilt>
<lotSizeSqFt>4680</lotSizeSqFt>
<finishedSqFt>3470</finishedSqFt>
<bathrooms>3.0</bathrooms>
<bedrooms>4</bedrooms>
<lastSoldDate>11/26/2008</lastSoldDate>
<lastSoldPrice currency="USD">995000</lastSoldPrice>
<zestimate>
<amount currency="USD">1219500</amount>
<last-updated>12/31/1969</last-updated>
<oneWeekChange deprecated="true"/>
<valueChange duration="30" currency="USD">-41500</valueChange>
<valuationRange>
<low currency="USD">1024380</low>
<high currency="USD">1378035</high>
</valuationRange>
<percentile>0</percentile>
</zestimate>
<localRealEstate>
<region id="271856" type="neighborhood" name="East Queen Anne">
<zindexValue>525,397</zindexValue>
<zindexOneYearChange>-0.144</zindexOneYearChange>
<links>
<overview>
http://www.zillow.com/local-info/WA-Seattle/East-Queen-Anne/r_271856/
</overview>
<forSaleByOwner>
http://www.zillow.com/homes/fsbo/East-Queen-Anne-Seattle-WA/
</forSaleByOwner>
<forSale>
http://www.zillow.com/east-queen-anne-seattle-wa/
</forSale>
</links>
</region>
<region id="16037" type="city" name="Seattle">
<zindexValue>381,764</zindexValue>
<zindexOneYearChange>-0.074</zindexOneYearChange>
<links>
<overview>
http://www.zillow.com/local-info/WA-Seattle/r_16037/
</overview>
<forSaleByOwner>http://www.zillow.com/homes/fsbo/Seattle-WA/</forSaleByOwner>
<forSale>http://www.zillow.com/seattle-wa/</forSale>
</links>
</region>
<region id="59" type="state" name="Washington">
<zindexValue>263,278</zindexValue>
<zindexOneYearChange>-0.066</zindexOneYearChange>
<links>
<overview>
http://www.zillow.com/local-info/WA-home-value/r_59/
</overview>
<forSaleByOwner>http://www.zillow.com/homes/fsbo/WA/</forSaleByOwner>
<forSale>http://www.zillow.com/wa/</forSale>
</links>
</region>
</localRealEstate>
</result>
</results>
</response>
</SearchResults:searchresults>

XML Schema Definition (XSD)

The XSD for the API is located at: http://www.zillow.com/static/xsd/SearchResults.xsd

<?xml version="1.0" encoding="utf-8" ?> 
<xsd:schema attributeFormDefault="unqualified" elementFormDefault="unqualified" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:ZillowTypes="http://www.zillow.com/vstatic/3/static/xsd/ZillowTypes.xsd" targetNamespace="http://www.zillow.com/vstatic/3/static/xsd/SearchResults.xsd">
<xsd:import namespace="http://www.zillow.com/vstatic/3/static/xsd/ZillowTypes.xsd" /> 
<xsd:element name="searchresults">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="request">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="address" type="xsd:string" /> 
<xsd:element name="citystatezip" type="xsd:string" /> 
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:element name="message" type="ZillowTypes:Message" /> 
<xsd:element minOccurs="0" name="response">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="results">
<xsd:complexType>
<xsd:sequence>
<xsd:element minOccurs="1" maxOccurs="unbounded" name="result" type="ZillowTypes:SimpleProperty" /> 
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:schema>

Have a question? Find help from a Pro here.