API illustration

Zillow API Network

GetSearchResults API

The GetSearchResults API finds a property for a specified address. The content returned contains the address for the property or properties as well as the Zillow Property ID (ZPID) and current Zestimate®. It also includes the date the Zestimate was computed, a valuation range and the Zestimate ranking for the property within its ZIP code. If no exact address match for a property is found, a list of closely matching properties is returned.

Search results are only available for properties that have Zestimates; if a property does not have a Zestimate, then it will not display in the search results.

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

The parameters of the API are:

Parameter Description Required
zws-id The 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
address The address of the property to search. This string should be URL encoded. Yes
citystatezip The 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

The API result set:

Parameter Description
zpid The 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
  • My Estimator 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 date
  • 30-day change (in $)
  • Valuation range (high) (in $)
  • Valuation range (low) (in $)
  • Percentile (?)
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>
&nbsp; <text>Request successfully processed</text>
&nbsp; <code>0</code>
&nbsp; <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 code Description Resolution
0 Request successfully processed
1 Service error-there was a server-side error while processing the request Check to see if your url is properly formed: delimiters, character cases, etc.
2 The specified ZWSID parameter was invalid or not specified in the request Check 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.
3 Web services are currently unavailable The Zillow Web Service is currently not available. Please come back later and try again.
4 The API call is currently unavailable The Zillow Web Service is currently not available. Please come back later and try again.
500 Invalid or missing address parameter Check if the input address matches the format specified in the input parameters table. When inputting a city name, include the state too. A city name alone will not result in a valid address.
501 Invalid or missing citystatezip parameter Same as error 500.
502 No results found Sorry, the address you provided is not found in Zillow's property database.
503 Failed to resolve city, state or ZIP code Please check to see if the city/state you entered is valid. If you provided a ZIP code, check to see if it is valid.
504 No coverage for specified area The specified area is not covered by the Zillow property database. To see our property coverage tables, click here.
505 Timeout Your request timed out. The server could be busy or unavailable. Try again later.

Sample API Call

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/GetSearchResults.htm?zws-id=<ZWSID>&address=2114+Bigelow+Ave&citystatezip=Seattle%2C+WA

Sample API Output

<?xml version="1.0" encoding="utf-8" ?> 
<SearchResults:searchresults xmlns:SearchResults="http://www.zillow.com/vstatic/3/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.htm?city=SEATTLE+&state=WA&zprop=48749425&partner=<ZWSID></homedetails> 
<graphsanddata>http://www.zillow.com/Charts.htm?chartDuration=1year&zpid=48749425&cbt=7539332184936698527%7E6%7EQfx6yogHrAI8nbK0h08BMT90x4V8jO7i8n7y%2BzmUaQU%3D&partner=<ZWSID></graphsanddata> 
<mapthishome>http://www.zillow.com/search/Search.htm?mode=search&zpid=48749425&partner=<ZWSID></mapthishome> 
<myestimator deprecated="true">http://www.zillow.com/myzestimator/MyZestimatorHomeFactsPage.htm?context=1157752261267&zprop=48749425&partner=<ZWSID></myestimator>
<myzestimator deprecated="true">http://www.zillow.com/myzestimator/MyZestimatorHomeFactsPage.htm?context=1157752261267&zprop=48749425&partner=<ZWSID></myzestimator> 
</links>
<address>
<street>2114 Bigelow Ave N</street> 
<zipcode>98109</zipcode> 
<city>SEATTLE</city> 
<state>WA</state> 
<latitude>47.637934</latitude> 
<longitude>-122.347936</longitude> 
</address>
<zestimate>
<amount currency="USD">1241162</amount> 
<last-updated>10/25/2007</last-updated> 
<oneWeekChange deprecated="true"/> 
<valueChange currency="USD" duration="30">58620</valueChange>
<valuationRange>
<low currency="USD">966702</low> 
<high currency="USD">1236479</high> 
</valuationRange>
<percentile /> 
</zestimate>
</result>
</results>
</response>
</SearchResults:searchresults>
<!-- 
H:11  T:14ms  S:1066 
-->

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>
pageName