Python-Zillow

A Python wrapper around the Zillow API.

By the Python-Zillow Developers

Introduction

This library provides a Python interface for the Zillow API. It works with Python versions from 2.6+.

Zillow provides a service that allows people to research the value of home across the United States. Zillow exposes this information via a web services API and this library is intended to make it easier for Python developers to use.

Installing

You can install python-zillow using:

 pip install python-zillow

Getting the code

The code is hosted at https://github.com/seme0021/python-zillow

Check out the latest development version anonymously with::

 $ git clone git://github.com/seme0021/python-zillow.git
$ cd python-zillow

Setup a virtual environment and install dependencies:

	$ virtualenv env

Activate the virtual environment created:

	$ source env/bin/activate

Running Tests

Note that tests require pip install nose and optionally pip install coverage:

To run the unit tests:

	make test

to also run code coverage:

 make coverage

Basic Tutorial on Searching Zillow

Here is some basic python code to query the zillow api using the python-zillow library.

Note: I suggest keeping your key stored in a ./bin/config/zillow_key.conf file

Initialize the API

importzillowwithopen("./bin/config/zillow_key.conf", 'r') asf:
key=f.readline().replace("\n", "")
api=zillow.ValuationApi()

Find a place given an address

address="3400 Pacific Ave., Marina Del Rey, CA"postal_code="90292"data=api.GetSearchResults(key, address, postal_code)

Find place using a zillow place id

zpid="2100641621"detail_data=api.GetZEstimate(key, zpid)

Find comparables

zpid="2100641621"detail_data=api.GetComps(key, zpid)

Get Deep Search Results

address="3400 Pacific Ave., Marina Del Rey, CA"postal_code="90292"data=api.GetDeepSearchResults(key, address, postal_code)

Get Deep Comps

zws_id="<your key>"zpid=2100641621count=10data=data=api.GetDeepComps(zws_id, zpid, count)