- Find a Real Estate Professional
- Stamford Realtors®
- Stamford Mortgage Lenders
- Stamford Home Improvement Pros
- Stamford Other Real Estate Services
- Review an Agent, Lender or Pro
- Marketing on Zillow
- Realtor® Advertising
- Join the Professional Directory
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:
| 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 |
| zipcode | The zipcode of the region to search. Either this zipcode parameter or the citystatezip parameter must be set. | No |
| citystatezip | The 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 |
| rental | Set true to return rental properties. | No |
| postingType | The 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:
| Parameter | Description |
|---|---|
| Posting counts | Count of the number of postings that match the API query, broken out by posting type:
|
| zpid | Zillow property ID for each property returned. |
| Full address | The complete address for the property:
|
| Posting details | Details specific to each returned 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: |
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>