Zillow API Network
GetZestimate API
For a specified Zillow property identifier (zpid), the GetZestimate API returns:
The most recent property Zestimate
The date the Zestimate was computed
The valuation range
The Zestimate ranking within the property's ZIP code.
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:
| 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. | Yes |
| zpid | The Zillow Property ID for the property for which to obtain information. The parameter type is an integer. | Yes |
The result set of the API:
| Parameter | Description |
|---|---|
| Full address | The complete address for the property:
|
| Zestimate data | Zestimate related data:
|
| Links | URLs to specific Zillow pages 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>
|
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 | Invalid ZWSID parameter specified-either the account does not exist or was disabled | 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 API Network@zillow.com 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 | The specified zpid parameter was not specified or invalid | The zpid parameter you have provided is not valid. Please check if your zpid is correct and try again. |
| 501 | There is no record in our database that corresponds to the specified zpid parameter | The 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. |
| 502 | The property identified by the specified zpid does not have a Zestimate | We 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 Output
<?xml version="1.0" encoding="utf-8" ?> <Zestimate:zestimate xmlns:Zestimate="http://www.zillow.com/vstatic/3/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.htm?city=SEATTLE+&state=WA&zprop=48749425&partner=<ZWSID></homedetails> <graphsanddata>http://www.zillow.com/Charts.htm?chartDuration=1year&zpid=48749425&cbt=7861999282116517979%7E10%7EWO5hva25AuN3gdluRPpxP9yjE3fHJERFMHMdlNOVwJE%3D&partner=<ZWSID></graphsanddata> <mapthishome>http://www.zillow.com/search/Search.htm?mode=search&zpid=48749425&partner=<ZWSID></mapthishome> <myestimator>http://www.zillow.com/myzestimator/MyZestimatorHomeFactsPage.htm?context=1157754698779&zprop=48749425&partner=<ZWSID></myestimator> <myzestimator deprecated="true">http://www.zillow.com/myzestimator/MyZestimatorHomeFactsPage.htm?context=1157754698779&zprop=48749425&partner=<ZWSID></myzestimator> </links> <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">947475</low> <high currency="USD">1211886</high> </valuationRange> <percentile>92</percentile> </zestimate> <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> <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> <!-- H:11 T:6ms S:904 -->
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>
