API illustration

Zillow API Network

GetRegionPostings API

The GetRegionPostings API returns a list of properties that are for sale, for rent, or have a Make Me Move® price in a given ZIP code, neighborhood, region id, or city. The API result set will return a count of postings broken out by posting type, which include for sale by owner, for sale by agent, and Make Me Move®. The result set also includes some high-level details about each property, such as the beds, baths, square footage, and price. Some information that has been submitted by listings feeds may not be included due to legal restrictions.

Note: Only "manually posted" listings will be returned via the API. Listings from Zillow Listings Feed partners - such as Keller Williams, ERA, and Weichert - are not returned.

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
zipcodeThe zipcode of the region to search. Either this zipcode parameter or the citystatezip parameter must be set. No
citystatezipThe city+state combination and/or ZIP code in which to search. This string should be URL encoded. Note that giving both city and state is required. Using just one will not work.No
rentalSet true to return rental properties.No
postingTypeThe type of for sale listings to return. The default is 'all'. To return only for sale by owner, set 'fsbo'. To return only for sale by agent, set 'fsba'. To return only Make Me Move®, set 'mmm'. Set 'none' and the rental parameter to true to return only rentals. No

The result set of the API:

ParameterDescription
Posting countsCount of the number of postings that match the API query, broken out by posting type:
  • Make Me Move®
  • For sale by owner
  • For sale by agent
  • Report for sale
  • For rent
zpidZillow property ID for each property returned.
Full addressThe complete address for the property:
  • Street address
  • ZIP code
  • City
  • State
  • Latitude
  • Longitude
Posting detailsDetails specific to each returned property:
  • Last updated date
  • Usecode
  • Lot size
  • Finished square footage
  • Bathrooms
  • Bedrooms
  • Price
  • Image count
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.

Sample API Call

Below is an example of calling the API for the 98102 zipcode:
http://www.zillow.com/webservice/GetRegionPostings.htm?zws-id=<ZWSID>&zipcode=98102&rental=true

Sample API Output

    	<?xml version="1.0" encoding="utf-8"?>
    	<RegionPostings:regionPostings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.zillow.com/static/xsd/RegionPostings.xsd http://www.zillowstatic.com/vstatic/acea5d5259e6fd794138a4edb539f4f0/static/xsd/RegionPostings.xsd" xmlns:RegionPostings="http://www.zillow.com/static/xsd/RegionPostings.xsd">
    		<request>
    			<zipcode>98102</zipcode>
    		</request>
    		<message>
    			<text>Request successfully processed</text>
    			<code>0</code>
    		</message>
    		<response>
    			<regionId>99562</regionId>
    			<links>
    			<forSale>http://www.zillow.com/homes/for_sale/Seattle-WA-98102/</forSale>
    			<forSaleByOwner>http://www.zillow.com/homes/fsbo/Seattle-WA-98102/</forSaleByOwner>
    			<foreclosures>http://www.zillow.com/homes/for_sale/Seattle-WA-98102/fore_lt/0_mmm/</foreclosures>
    			</links>
    	<makeMeMove>
    		<count>1</count>
    		<result>
    			<lastRefreshedDate>2010-07-30 10:42:00.0</lastRefreshedDate>
    			<property>
    				<zpid>2130744507</zpid>
    				<links>
    					<homedetails>http://www.zillow.com/homedetails/708-11th-Ave-E-Seattle-WA-98102/2130744507_zpid/</homedetails>
    				</links>
    				<address>
    					<street>708 11th Ave E</street>	
    					<zipcode>98102</zipcode>
    					<city>Seattle</city>
    					<state>WA</state>
    						<latitude>47.625574</latitude>
    						<longitude>-122.317735</longitude>
    				</address>
    				<useCode>Single Family</useCode>
    				<lotSizeSqFt></lotSizeSqFt>
    				<finishedSqFt></finishedSqFt>
    				<bathrooms></bathrooms>
    				<bedrooms></bedrooms>
    			</property>
    			<images>
    				<count>0</count>
    			</images>
    			<price>695000</price>
    		</result>
    	</makeMeMove>
    	<forSaleByOwner>
    		<count>0</count>
    	</forSaleByOwner>
    	<forSaleByAgent>
    		<count>1</count>
    		<result>
    			<lastRefreshedDate>2010-08-09 14:48:00.0</lastRefreshedDate>
    			<property>
    				<zpid>2130622410</zpid>
    				<links>
    					<homedetails>http://www.zillow.com/homedetails/626-13th-Ave-E-APT-J-Seattle-WA-98102/2130622410_zpid/</homedetails>
    				</links>
    				<address>
    					<street>626 13th Ave E APT J</street>	
    					<zipcode>98102</zipcode>
    					<city>Seattle</city>
    					<state>WA</state>
    						<latitude>47.6248</latitude>
    						<longitude>-122.31558</longitude>
    				</address>
    				<useCode>Single Family</useCode>
    				<lotSizeSqFt></lotSizeSqFt>
    				<finishedSqFt></finishedSqFt>
    				<bathrooms>1.0</bathrooms>
    				<bedrooms>1</bedrooms>
    			</property>
    			<images>
    				<count>8</count>
    			</images>
    			<price>239950</price>
    		</result>
    	</forSaleByAgent>
    	<reportForSale>
    		<count>0</count>
    	</reportForSale>
    	<forRent>
    		<count>1</count>
    		<result>
    			<lastRefreshedDate>2010-09-01 00:00:00.0</lastRefreshedDate>
    			<property>
    				<zpid>48793033</zpid>
    				<links>
    					<homedetails>http://localhost:8080/homedetails/2350-10th-Ave-E-APT-108-Seattle-WA-98102/48793033_zpid/</homedetails>
    				</links>
    				<address>
    					<street>2350 10th Ave E APT 108</street>	
    					<zipcode>98102</zipcode>
    					<city>Seattle</city>
    					<state>WA</state>
    						<latitude>47.641772</latitude>
    						<longitude>-122.319988</longitude>
    				</address>
    				<useCode>Condo</useCode>
    				<lotSizeSqFt>28497</lotSizeSqFt>
    				<finishedSqFt>900</finishedSqFt>
    				<bathrooms>2.0</bathrooms>
    				<bedrooms>2</bedrooms>
    			</property>
    			<images>
    				<count>15</count>
    			</images>
    			<price>1995</price>
    		</result>
    	</forRent>
    	</response>
    	</RegionPostings:regionPostings>
    	

Have a question? Find help from a Pro here.