Zillow API Network

GetDeepComps API

The GetDeepComps API returns a list of comparable recent sales for a specified property. The result set returned contains the address, Zillow property identifier, and Zestimate for the comparable properties and the principal property for which the comparables are being retrieved. This API call also returns rich property data for the comparables.

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

The parameters to 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
count	The number of comparable recent sales to obtain	Yes

The result set of the API:

The following result set is obtained for each comparable and also the principal property that was provided as input to the API call.

Parameter	Description
zpid	Zillow property ID for the property.
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 One week change (in $) Valuation range (high) (in $) Valuation range (low) (in $) Percentile (?)
Links	URLs to specific Zillow pages for this property: Home details page Chart data page Map this home page My Estimator page
Tax assessment year	The year of the most recent tax assessment
Tax assessment	The most recent tax assessment
Yearbuilt	The year in which the property was constructed.
lotsizeSqFt	The size of the lot in sq. ft.
finishedSqFt	The size of the finished property in sq. ft.
Bathrooms	Number of bathrooms in the property.
Bedrooms	Number of bedrooms in the property.
LastSoldDate	The date of last sale for this property.
LastSoldPrice	The price of the last sale for this property.
Compscore	This data is provided for comparable homes. It is a number between 0 to 1 that indicates how close the comparable is to the target property. API implementations can use this data to sort the comparables by relevance, with 1 being the most relevant.
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

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	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	The specified count parameter was not specified or invalid	The count parameter which tells the api how many comparable homes to return is mandatory. Please check if you have specified a valid integer greater than or equal to 1.
502	There is no record in our database that corresponds to the specified zpid parameter	The zpid you provided didn't match 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.
503	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.
504	No results	There were no comparables for the property you specified.

Sample Calls

Below is an example of calling the GetDeepComps API for zpid 48749425 and count of 5 comps:
http://www.zillow.com/webservice/GetDeepComps.htm?zws-id=<ZWSID<&zpid=48749425&count=5

Sample Output

<?xml version="1.0" encoding="utf-8" ?> 
<Comps:comps xmlns:Comps="http://www.zillow.com/vstatic/3/static/xsd/Comps.xsd">
<request>
<zpid>48749425</zpid> 
<count>5</count> 
</request>
<message>
<text>Request successfully processed</text> 
<code>0</code> 
</message>
<response>
<properties>
<principal>
<zpid>48749425</zpid> 
<links>
<homedetails>http://www.tes3.zillow.local/HomeDetails.htm?city=SEATTLE+&state=WA&zprop=48749425&partner=A347523198</homedetails> 
<graphsanddata>http://www.tes3.zillow.local/Charts.htm?chartDuration=1year&zpid=48749425&cbt=812516705778109785%7E8%7EwQa1GToapGduDwMxTV%2FmesbTDvfTn58adNfrRcSrOQ4%3D&partner=A347523198</graphsanddata> 
<mapthishome>http://www.tes3.zillow.local/search/Search.htm?mode=search&zpid=48749425&partner=A347523198</mapthishome> 
 <myestimator>http://www.tes3.zillow.local/myestimator/Intro.htm?zprop=48749425&partner=A347523198</myestimator>
<myzestimator deprecated="true">http://www.tes3.zillow.local/myestimator/Intro.htm?zprop=48749425&partner=A347523198</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>
<taxAssessment>816000.0</taxAssessment> 
<yearBuilt>1924</yearBuilt> 
<lastSoldDate>06/18/2002</lastSoldDate> 
<zestimate>
<amount currency="USD">1091061</amount> 
<last-updated>05/26/2006</last-updated> 
<oneWeekChange currency="USD">61096</oneWeekChange> 
<valuationRange>
<low currency="USD">938312</low> 
<high currency="USD">1200167</high> 
</valuationRange>
<percentile>93</percentile> 
</zestimate>
</principal>
<comparables>
<comp score="0.3011561599817497">
<zpid>48878959</zpid> 
<links>
<homedetails>http://www.tes3.zillow.local/HomeDetails.htm?city=SEATTLE+&state=WA&zprop=48878959&partner=A347523198</homedetails> 
<graphsanddata>http://www.tes3.zillow.local/Charts.htm?chartDuration=1year&zpid=48878959&cbt=812516705778109785%7E8%7EwQa1GToapGduDwMxTV%2FmesbTDvfTn58adNfrRcSrOQ4%3D&partner=A347523198</graphsanddata> 
<mapthishome>http://www.tes3.zillow.local/search/Search.htm?mode=search&zpid=48878959&partner=A347523198</mapthishome> 
<myzestimator>http://www.tes3.zillow.local/myestimator/Intro.htm?zprop=48878959&partner=A347523198</myzestimator> 
</links>
<address>
<street>2407 4th Ave N</street> 
<zipcode>98109</zipcode> 
<city>SEATTLE</city> 
<state>WA</state> 
<latitude>47.64023</latitude> 
<longitude>-122.34988</longitude> 
</address>
<yearBuilt>1915</yearBuilt> 
<lotSizeSqFt>4000</lotSizeSqFt> 
<finishedSqFt>2590</finishedSqFt> 
<bathrooms>2.5</bathrooms> 
<bedrooms>3</bedrooms> 
<lastSoldDate>04/27/2006</lastSoldDate> 
<lastSoldPrice currency="USD">1100000</lastSoldPrice> 
<zestimate>
<amount currency="USD">1046716</amount> 
<last-updated>05/26/2006</last-updated> 
<oneWeekChange currency="USD">46719</oneWeekChange> 
<valuationRange>
<low currency="USD">900176</low> 
<high currency="USD">1151388</high> 
</valuationRange>
<percentile /> 
</zestimate>
</comp>
<comp score="0.32708506597170584">
<zpid>48749414</zpid> 
<links>
<homedetails>http://www.tes3.zillow.local/HomeDetails.htm?city=SEATTLE+&state=WA&zprop=48749414&partner=A347523198</homedetails> 
<graphsanddata>http://www.tes3.zillow.local/Charts.htm?chartDuration=1year&zpid=48749414&cbt=812516705778109785%7E8%7EwQa1GToapGduDwMxTV%2FmesbTDvfTn58adNfrRcSrOQ4%3D&partner=A347523198</graphsanddata> 
<mapthishome>http://www.tes3.zillow.local/search/Search.htm?mode=search&zpid=48749414&partner=A347523198</mapthishome> 
<myzestimator>http://www.tes3.zillow.local/myestimator/Intro.htm?zprop=48749414&partner=A347523198</myzestimator> 
</links>
<address>
<street>463 Lynn St</street> 
<zipcode>98109</zipcode> 
<city>SEATTLE</city> 
<state>WA</state> 
<latitude>47.638885</latitude> 
<longitude>-122.347615</longitude> 
</address>
<yearBuilt>1922</yearBuilt> 
<lotSizeSqFt>3880</lotSizeSqFt> 
<finishedSqFt>1680</finishedSqFt> 
<bathrooms>1.75</bathrooms> 
<bedrooms>3</bedrooms> 
<lastSoldDate>11/30/2005</lastSoldDate> 
<lastSoldPrice currency="USD">929000</lastSoldPrice> 
<zestimate>
<amount currency="USD">964842</amount> 
<last-updated>05/26/2006</last-updated> 
<oneWeekChange currency="USD">19774</oneWeekChange> 
<valuationRange>
<low currency="USD">829764</low> 
<high currency="USD">1061326</high> 
</valuationRange>
<percentile /> 
</zestimate>
</comp>
<comp score="0.4290031404113939">
<zpid>48749484</zpid> 
<links>
<homedetails>http://www.tes3.zillow.local/HomeDetails.htm?city=SEATTLE+&state=WA&zprop=48749484&partner=A347523198</homedetails> 
<graphsanddata>http://www.tes3.zillow.local/Charts.htm?chartDuration=1year&zpid=48749484&cbt=812516705778109785%7E8%7EwQa1GToapGduDwMxTV%2FmesbTDvfTn58adNfrRcSrOQ4%3D&partner=A347523198</graphsanddata> 
<mapthishome>http://www.tes3.zillow.local/search/Search.htm?mode=search&zpid=48749484&partner=A347523198</mapthishome> 
<myzestimator>http://www.tes3.zillow.local/myestimator/Intro.htm?zprop=48749484&partner=A347523198</myzestimator> 
</links>
<address>
<street>1622 Bigelow Ave N</street> 
<zipcode>98109</zipcode> 
<city>SEATTLE</city> 
<state>WA</state> 
<latitude>47.633784</latitude> 
<longitude>-122.347981</longitude> 
</address>
<yearBuilt>1921</yearBuilt> 
<lotSizeSqFt>11000</lotSizeSqFt> 
<finishedSqFt>2380</finishedSqFt> 
<bathrooms>1.5</bathrooms> 
<bedrooms>5</bedrooms> 
<lastSoldDate>02/09/2006</lastSoldDate> 
<lastSoldPrice currency="USD">970000</lastSoldPrice> 
<zestimate>
<amount currency="USD">1054021</amount> 
<last-updated>05/26/2006</last-updated> 
<oneWeekChange currency="USD">-15927</oneWeekChange> 
<valuationRange>
<low currency="USD">906458</low> 
<high currency="USD">1159423</high> 
</valuationRange>
<percentile /> 
</zestimate>
</comp>
<comp score="0.46991060493924836">
<zpid>48690001</zpid> 
<links>
<homedetails>http://www.tes3.zillow.local/HomeDetails.htm?city=SEATTLE+&state=WA&zprop=48690001&partner=A347523198</homedetails> 
<graphsanddata>http://www.tes3.zillow.local/Charts.htm?chartDuration=1year&zpid=48690001&cbt=812516705778109785%7E8%7EwQa1GToapGduDwMxTV%2FmesbTDvfTn58adNfrRcSrOQ4%3D&partner=A347523198</graphsanddata> 
<mapthishome>http://www.tes3.zillow.local/search/Search.htm?mode=search&zpid=48690001&partner=A347523198</mapthishome> 
<myzestimator>http://www.tes3.zillow.local/myestimator/Intro.htm?zprop=48690001&partner=A347523198</myzestimator> 
</links>
<address>
<street>1823 Nob Hill Ave N</street> 
<zipcode>98109</zipcode> 
<city>SEATTLE</city> 
<state>WA</state> 
<latitude>47.635558</latitude> 
<longitude>-122.351036</longitude> 
</address>
<yearBuilt>1905</yearBuilt> 
<lotSizeSqFt>4000</lotSizeSqFt> 
<finishedSqFt>1460</finishedSqFt> 
<bathrooms>1.0</bathrooms> 
<bedrooms>3</bedrooms> 
<lastSoldDate>04/04/2006</lastSoldDate> 
<lastSoldPrice currency="USD">925000</lastSoldPrice> 
<zestimate>
<amount currency="USD">925000</amount> 
<last-updated>05/26/2006</last-updated> 
<oneWeekChange currency="USD">338519</oneWeekChange> 
<valuationRange>
<low currency="USD">795500</low> 
<high currency="USD">1017500</high> 
</valuationRange>
<percentile /> 
</zestimate>
</comp>
<comp score="0.5149147396751322">
<zpid>49013442</zpid> 
<links>
<homedetails>http://www.tes3.zillow.local/HomeDetails.htm?city=SEATTLE+&state=WA&zprop=49013442&partner=A347523198</homedetails> 
<graphsanddata>http://www.tes3.zillow.local/Charts.htm?chartDuration=1year&zpid=49013442&cbt=812516705778109785%7E8%7EwQa1GToapGduDwMxTV%2FmesbTDvfTn58adNfrRcSrOQ4%3D&partner=A347523198</graphsanddata> 
<mapthishome>http://www.tes3.zillow.local/search/Search.htm?mode=search&zpid=49013442&partner=A347523198</mapthishome> 
<myzestimator>http://www.tes3.zillow.local/myestimator/Intro.htm?zprop=49013442&partner=A347523198</myzestimator> 
</links>
<address>
<street>1715 Bigelow Ave N</street> 
<zipcode>98109</zipcode> 
<city>SEATTLE</city> 
<state>WA</state> 
<latitude>47.634464</latitude> 
<longitude>-122.348744</longitude> 
</address>
<yearBuilt>1925</yearBuilt> 
<lotSizeSqFt>4815</lotSizeSqFt> 
<finishedSqFt>1970</finishedSqFt> 
<bathrooms>1.5</bathrooms> 
<bedrooms>2</bedrooms> 
<lastSoldDate>11/09/2005</lastSoldDate> 
<lastSoldPrice currency="USD">949000</lastSoldPrice> 
<zestimate>
<amount currency="USD">962770</amount> 
<last-updated>05/26/2006</last-updated> 
<oneWeekChange currency="USD">45485</oneWeekChange> 
<valuationRange>
<low currency="USD">827982</low> 
<high currency="USD">1059047</high> 
</valuationRange>
<percentile /> 
</zestimate>
</comp>
</comparables>
</properties>
</response>
</Comps:comps>
<!-- 
 H:33  T:424ms  S:6911  R:Tue Sep 12 21:45:28 UTC 2006  B:2.0.11749_060912_1 
-->

XML Schema Definition (XSD)

The XSD for the API can be found at: http://www.zillow.com/static/xsd/Comps.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/Comps.xsd">
<xsd:import namespace="http://www.zillow.com/vstatic/2/static/xsd/ZillowTypes.xsd" /> 
<xsd:element name="comps">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="request">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="zpid" type="xsd:string" /> 
<xsd:element name="count" 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="properties">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="principal" type="ZillowTypes:SimpleProperty" /> 
<xsd:element name="comparables">
<xsd:complexType>
<xsd:sequence>
<xsd:element minOccurs="1" maxOccurs="unbounded" name="comp" type="ZillowTypes:ComparableProperty" /> 
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:schema>

Property Details API

GetDeepComps API

Zillow API Network

GetDeepComps API

The parameters to the API are:

The result set of the API:

Messages and Codes

Sample Calls

Sample Output

XML Schema Definition (XSD)