Fast, Multi-Source Rental Search for York Region, Ontario

rentFalcon is a powerful rental listing aggregator that searches multiple rental websites simultaneously and displays all results in one clean interface. Stop checking Kijiji, Rentals.ca, and other sites separately!

Perfect for finding rentals in Newmarket, ON and surrounding areas (Aurora, Richmond Hill, Bradford, Markham, Vaughan, and more).

• 🔍 Multi-Source Search - Searches Kijiji and Rentals.ca at once
• ⚡ Fast Results - Get 30-50 listings in 10-15 seconds
• 🎯 Smart Deduplication - Automatically removes duplicate listings
• 🏘️ 8 Cities Supported - Newmarket area within 25 km radius
• 💰 Price Filtering - Set your budget and find matches
• 🆓 Completely Free - No ads, no subscriptions, no hidden costs
• 🖥️ User-Friendly - Clean web interface, no technical knowledge required

Clean, simple search form with location and price filters.

All listings from multiple sources in one place, with duplicate removal.

1. Download the project (.zip file)
2. Double-click EASY_SETUP.bat
3. Follow on-screen instructions (5 minutes)
4. Start searching! Use desktop shortcut or START_RENTAL_SCANNER.bat

That's it! Everything installs automatically.

# Clone the repository
git clone https://github.com/yourusername/rentFalcon.git
cd rentFalcon

# Install dependencies
pip install -r requirements.txt

# Run the application
python app.py

Visit http://localhost:5000 in your browser.

• Python 3.8+
• Google Chrome (for Rentals.ca scraper)
• Internet connection
• Windows 10/11 (batch files for Windows; manual setup for Mac/Linux)

rentFalcon searches rentals in these cities within 25 km of Newmarket:

• User Guide - Complete guide for non-technical users
• Quick Reference - Quick tips and commands
• Installation Guide - Detailed setup instructions
• Newmarket Quick Start - Search examples and tips

# Run the easy setup script
EASY_SETUP.bat

This will:

• ✅ Check Python installation
• ✅ Check Chrome installation
• ✅ Install all required packages
• ✅ Create desktop shortcut
• ✅ Launch the application

# Install core dependencies
pip install Flask Flask-SQLAlchemy requests beautifulsoup4 selenium webdriver-manager python-dotenv APScheduler

# Run the application
python app.py

Windows:

• Double-click START_RENTAL_SCANNER.bat
• Or use the desktop shortcut "rentFalcon"

Manual:

python app.py

1. Open http://localhost:5000 in your browser
2. Enter location (default: Newmarket)
3. Set price range (optional)
4. Click "Search Rentals"
5. View 30-50 results in 10-15 seconds!

Affordable 1-Bedroom in Newmarket:

Location: Newmarket
Min Price: 1400
Max Price: 1800

Family Home in Aurora:

Location: Aurora
Min Price: 2000
Max Price: 2800

• Backend: Python 3.13, Flask 3.1
• Scraping: BeautifulSoup, Selenium, Requests
• Browser Automation: Selenium WebDriver, ChromeDriver
• Scheduling: APScheduler
• Frontend: HTML, CSS, Vanilla JavaScript

• Parallel Scraping - All scrapers run simultaneously
• Smart Deduplication - 85% similarity threshold
• Automatic Retries - Handles temporary failures
• Rate Limiting - Respects source websites
• Caching - ChromeDriver cached after first download
• Error Handling - Graceful failures, app continues

• ✅ No data collection - Everything runs locally
• ✅ No tracking - Your searches are private
• ✅ No accounts - No login required
• ✅ Read-only - Only reads public listings
• ✅ Open source - Inspect the code yourself

rentFalcon/
├── app.py                  # Main Flask application
├── config.py              # Configuration
├── scrapers/              # Scraper modules
│   ├── base_scraper.py   # Base scraper class
│   ├── kijiji_scraper.py # Kijiji implementation
│   ├── rentals_ca_scraper.py # Rentals.ca implementation
│   └── scraper_manager.py # Coordinates scrapers
├── templates/             # HTML templates
│   └── index.html        # Main search interface
├── static/               # CSS and assets
├── models/               # Database models
└── docs/                 # Documentation

python test_scrapers.py

1. Create new scraper class in scrapers/
2. Inherit from BaseScraper
3. Implement required methods
4. Register in scraper_manager.py
5. Test and submit PR!

Contributions are welcome! Here's how:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

• Add more rental sources (Facebook Marketplace, PadMapper, etc.)
• Support for Mac/Linux
• Add saved searches feature
• Email notifications for new listings
• Map view of results
• Export to CSV/Excel
• Mobile app version
• More cities/regions

• Install Python from python.org
• Important: Check "Add Python to PATH" during installation
• Restart computer

• Install Chrome from google.com/chrome
• Run EASY_SETUP.bat again

• Check spelling of city name
• Remove price filters
• Try a different city
• Verify internet connection

• Normal! ChromeDriver downloads on first run (30-60 seconds)
• Only happens once
• Subsequent searches are fast (10-15 seconds)

More help: See USER_GUIDE_SIMPLE.md

This project is licensed under the MIT License - see the LICENSE file for details.

• Original Creator - jd gramsci

• Thanks to all the rental websites for providing public data, thank you to Inn from the Cold for the inspiration
• Built with Flask, BeautifulSoup, and Selenium
• Inspired by the need for streamlined housing access, and the desire to build dual power where ever I can.

• Documentation: Check the docs/ folder
• Issues: Open an issue on GitHub
• Questions: See USER_GUIDE_SIMPLE.md

• ✅ Multi-source scraping (Kijiji + Rentals.ca)
• ✅ 8 cities in Newmarket area
• ✅ Easy setup for non-technical users
• ✅ Desktop shortcut support

• Add Facebook Marketplace scraper
• Saved searches feature
• Email/Discord/Telegram notifications
• Mac/Linux support

• Map view of listings
• Mobile app
• Web App
• Docker Image
• User accounts (optional)
• Expand to all Canadian provinces/territories

If rentFalcon helps you find a rental, please give it a star! ⭐

Share with your friends and take care of your community! Housing First!

• Lines of Code: ~5,000+
• Files: 50+
• Scrapers: 2 active (3 total)
• Cities Supported: 8
• Documentation Pages: 10+
• Development Time: 5 days
• Status: ✅ Production Ready

Made with ❤️ for the working class

🦅 rentFalcon - get the swoop on landlords

• Download Latest Release
• Report a Bug
• Request a Feature
• View Documentation

Last Updated: November 2025