tbirch4/chi-houses

Get data for Chicago houses with filtering by build year and neighborhood.

Chicago houses 🏠

Get data for Chicago houses with filtering by neighborhood and build year.

This uses property data from the Cook County Assessor and community area boundaries from the Chicago Data Portal. It can also retrieve property images from the Assessor's website--these images are typically better than other sources (e.g. Google Maps Street View) at (a) directly framing each building, and (b) clearly showing each building's features.

Example usage

Install with pip.

pip install git+https://github.com/tbirch4/chi-houses.git

Get houses data and images.

from chi_houses import Houses

community_areas = ['edgewater', 'logan square']
year_range = (1900, 1901)

houses = Houses(community_areas, year_range)

# Get list of matching properties.
houses.get_houses()

# Get an image of each property.
houses.get_images()

houses.house_list

Full residential characteristics data

By default, get_houses returns a minimal list of addresses meeting the search parameters. It gets a small subset of columns from the data source: address, tax pin, year built, and coordinates. However, the data source has many additional columns that could be helpful for machine learning and other applications. To access the full data, set the all_data parameter of get_houses to True. You can find a full list of columns here.