Find apartment advertisements that are relevant to you. Just configure the script with your criteria and receive emails with matching rental properties in Toronto.

Here's how it works: advertisements are scraped from Kijiji based on provided search criteria. Some of the basic criteria include price range, work location, and relevant unit types. After discarding duplicate adverts, the geographic coordinates are retrieved using the Google Maps Geocoding API. The coordinates are tested against a provided KML file to determine if they fall within your range. Any remaining adverts are sent to the provided email addresses via Amazon SES.

Hopefully this will help save you from wading through pages and pages of reposted and irrelevant advertisements when looking for a place to live.

The original idea for this project was inspired by toronto-apartment-finder. Please go check it out!

• Python 3.6+, for type hinting
• Redis, for caching seen advertisements
• Google Maps Geocoding API key
• Amazon SES credentials

Also make sure to install the Python requirements:

pip install -r requirements.txt

python main.py kml_filename

If you're curious how to generate a KML file, you can use Google MyMaps to draw and export your desired living area on a map. Your KML file can contain multiple different polygons

This script is configured via environment variables. Here are the available options:

Valid unit types are:

Feel free to use the provided Dockerfile to easily run this script in a production environment.