immoscrapy's Introduction

immoscrapy

Scrape Immobilienscout24 data using Python. You can use it as a Python library or a standalone CLI application.

Online documentation is available on https://readthedocs.org.

Immoscrapy is tested on Linux, Mac and Windows and all Python versions >= 3.7.

Quickstart

The CLI allows currently for four types of queries:

renting an apartment
buying an apartment
renting a house
buying a house

immoscrapy --help
usage: immoscrapy [-h] {rent-apartment,buy-apartment,rent-house,buy-house} ...

Query Immobilienscout24 offers

positional arguments:
  {rent-apartment,buy-apartment,rent-house,buy-house}

optional arguments:
  -h, --help            show this help message and exit

each of the types has its own set of options:

immoscrapy buy-apartment --help
usage: immoscrapy buy-apartment [-h] -c COUNTRY [-r REGION] [-z CITY] [-p PRICE] [-o NUMBEROFROOMS] [-s LIVINGSPACE] [-y CONSTRUCTIONYEAR]

Query for apartments for sale

optional arguments:
  -h, --help            show this help message and exit
  -c COUNTRY, --country COUNTRY
  -r REGION, --region REGION
  -z CITY, --city CITY
  -p PRICE, --price PRICE
                        price range: min-max, -max or min-
  -o NUMBEROFROOMS, --numberofrooms NUMBEROFROOMS
                        number of rooms: min-max, -max or min-
  -s LIVINGSPACE, --livingspace LIVINGSPACE
                        living space: min-max, -max or min-
  -y CONSTRUCTIONYEAR, --constructionyear CONSTRUCTIONYEAR
                        construction year: min-max, -max or min-

running it:

immoscrapy buy-apartment --country de --region berlin --price 100000-800000 --numberofrooms 5-
# get nicely formatted tabular data showing the results