An application to search, subscribe to, and email Craigslist Housing posts.
My partner and I were planning to move to the Bay Area in August 2020. Rather than constantly combing through Craigslist Housing for new posts, I decided to have some fun and write an app that emails me new housing posts that meet the location and desired specifications. I've since refactored and made better of this code. Hopefully it will be of use to whomever uses it.
View the video demo.
- Clone GitHub repository
pip install -r requirements.txt
python main.py
There are two windows in this application: main parameter window and subscription window.
In the main window, you will complete the Email form by completing the Email recipients along with a subject and message body, if desired. You may choose either apartments & housing or rooms & shares. The search distance criteria is set on miles from ZIP code. Select price range, area range (ft2), and number of bedrooms, if desired.
NOTE: bedrooms are not available for rooms and shares.
Once you click "Subscribe" in the main application, a series of checks will be conducted to ensure that your input credentials are appropriate. If passed, a subscription window will pop up, asking you if you would like to receive continuous notifications (updates) on new Cragislist posts given the input parameters. If a numeric value from the drop-down menu is selected, the user will receive updates (if there are new posts) once every given hour. If "None" is selected, the user will receive the one-time notification.
Make sure you have a Gmail account that is configured to send emails with Python. Watch this video to learn more.
To have Gmail and Password autopopulated, store your Gmail account and password information in your local environment under EMAIL_USER
and EMAIL_PASS
, respectively. Not doing this is OK, as well - you will have to fill this portion out manually, that's all.
Please submit any questions or issues here.