API illustration

Zillow API Network

GetZestimate API

For a specified Zillow property identifier (zpid), the GetZestimate API returns:

  1. The most recent property Zestimate

  2. The date the Zestimate was computed

  3. The valuation range

  4. The Zestimate ranking within the property's ZIP code.

  5. The full property address and geographic location (latitude/longitude) and a set of identifiers that uniquely represent the region (ZIP code, city, county & state) in which the property exists.

The GetZestimate API will only surface properties for which a Zestimate exists. If a request is made for a property that has no Zestimate, an error code is returned. Zillow doesn't have Zestimates for all the homes in its database. For such properties, we do have tax assessment data, but that is not provided through the API. For more information, see our Zestimate coverage.

The GetZestimate Web Service is located at:
http://www.zillow.com/webservice/GetZestimate.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. Yes
zpidThe Zillow Property ID for the property for which to obtain information. The parameter type is an integer.Yes
rentzestimateReturn Rent Zestimate information if available (boolean true/false, default: false)No

The result set of the API:

ParameterDescription
ZpidThe Zillow Property ID.
LinksURLs to specific Zillow pages for this property:
  • Home details page
  • Chart data page
  • Map this home page
  • Similar sales page
Full addressThe complete address for the property:
  • Street address
  • ZIP code
  • City
  • State
  • Latitude
  • Longitude
Zestimate dataZestimate related data:
  • Zestimate (in $)
  • Last updated
  • 30-day change (in $)
  • Valuation range (high) (in $)
  • Valuation range (low) (in $)
  • Percentile value
Rent Zestimate data Rent Zestimate related data:
  • Rent Zestimate (in $)
  • Last updated
  • 30-day (in $)
  • Valuation range (high) (in $)
  • Valuation range (low) (in $)
Local real estateReal 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.
Limit-warningIf 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
2Invalid ZWSID parameter specified-either the account does not exist or was disabledCheck 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 API Network@zillow.com to get help on fixing your ZWSID.
3Web services are currently unavailableThe 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.
500The specified zpid parameter was not specified or invalidThe zpid parameter you have provided is not valid. Please check if your zpid is correct and try again.
501There is no record in our database that corresponds to the specified zpid parameterThe zpid you provided didn't match to any of the property zpids in our database. Either the property is not available in our database or there might be a typo in the zpid.
502The property identified by the specified zpid does not have a ZestimateWe found the property, but we do not have a Zestimate for this property. See our Zestimate coverage table.

Sample Calls

Below is a sample call to the API for zpid 48749425:
http://www.zillow.com/webservice/GetZestimate.htm?zws-id=<ZWSID>&zpid=48749425

Sample API Output

<Zestimate:zestimate xsi:schemaLocation="http://www.zillow.com/static/xsd/Zestimate.xsd /vstatic/ae1bf8a790b67ef2e902d2bc04046f02/static/xsd/Zestimate.xsd">
<request>
<zpid>48749425</zpid>
</request>
<message>
<text>Request successfully processed</text>
<code>0</code>
</message>
<response>
<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=2950402095890968938%7E4%7ECh-lwa20e2Scegkf_Ev1dsQ2hJD7f74f1dovt2o0BMi2IuvfsZN-sg**
</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>
<zestimate>
<amount currency="USD">1219500</amount>
<last-updated>11/03/2009</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>95</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>
<regions>
<zipcode-id>99569</zipcode-id>
<city-id>16037</city-id>
<county-id>207</county-id>
<state-id>59</state-id>
</regions>
</response>
</Zestimate:zestimate>
			

XML Schema Definition (XSD

The XSD for the API is located at: http://www.zillow.com/static/xsd/Zestimate.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/2/static/xsd/ZillowTypes.xsd" targetNamespace="http://www.zillow.com/vstatic/2/static/xsd/Zestimate.xsd">
<xsd:import namespace="http://www.zillow.com/vstatic/2/static/xsd/ZillowTypes.xsd" />
<xsd:element name="zestimate">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="request">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="zpid" type="xsd:string" />
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:element name="message" type="ZillowTypes:Message" />
<xsd:element minOccurs="0" name="response" type="ZillowTypes:DetailedProperty" />
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:schema>
		

Have a question? Find help from a Pro here.

 
 
 
Sign in with Google