Skip to content

An application to search, subscribe to, and email Craigslist Housing posts.

Notifications You must be signed in to change notification settings

irahorecka/auto-craigslist-housing

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

auto-craigslist-housing

An application to search, subscribe to, and email Craigslist Housing posts.

Logo

Purpose

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.

Running the app

  • Clone GitHub repository
  • pip install -r requirements.txt
  • python main.py

Using the app

There are two windows in this application: main parameter window and subscription window.

Main 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.

Main

Subscription window

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.

Main

Important configuration notes

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.

Issues

Please submit any questions or issues here.

About

An application to search, subscribe to, and email Craigslist Housing posts.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published