/python-zillow

Python library for the Zillow API

Primary LanguagePythonApache License 2.0Apache-2.0

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

import zillow

with open("./bin/config/zillow_key.conf", 'r') as f:
    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 = 2100641621
count=10

data = data = api.GetDeepComps(zws_id, zpid, count)