An intelligent real estate bot that automatically finds and extracts property listings across the United States based on your search criteria. The bot uses SERP API to search for relevant real estate websites and Hyperbrowser to extract structured data from those sites.
Ready to find your next home? This bot does all the heavy lifting for you - no more manually browsing dozens of real estate websites!
- 🔍 Automatic Web Search: No need to manually enter URLs - the bot finds relevant real estate websites for you
- 🏠 Rent or Buy Options: Search for both rental properties and homes for sale
- 📊 Structured Data: Get organized listings with title, price, location, bedrooms, bathrooms, area, and direct links
- 🌐 Multi-site Support: Searches across popular US real estate platforms like Zillow, Apartments.com, Realtor.com, Trulia, Redfin, and more
You'll need API keys for:
- Hyperbrowser: Get your API key at hyperbrowser.ai
- SerpAPI: Sign up at SerpAPI to get your search API key
- Clone this repository and install dependencies:
npm install- Create a
.envfile in the root directory with your API keys:
HYPERBROWSER_API_KEY=your_hyperbrowser_api_key_here
SERPAPI_KEY=your_serpapi_key_hereRun the application:
npx tsx real-estate-bot.tsThe bot will prompt you for:
- Rent or Buy: Choose whether you're looking for rentals or properties for sale
- Location: City and state (e.g., "New York NY", "San Francisco CA", "Austin Texas")
- Bedrooms: Number of bedrooms (1, 2, 3, 4, 5+, or Any)
- Budget: Optional budget range (e.g., "3000" for $3,000/month rent or "$300k" for purchase)
- Property Type: apartment, house, condo, townhouse, studio, or Any
The bot will then:
- 🔍 Search for relevant real estate websites using your criteria
- 🌐 Find and validate real estate URLs from trusted US platforms
- 🤖 Extract structured listing data using Hyperbrowser
- 📋 Display organized results with all property details
🔍 Searching for: 2 bedroom apartment for rent in New York NY under $4000 site:zillow.com OR site:apartments.com...
✅ Found 5 relevant websites. Extracting listings...
🏠 Found 8 listings for rent:
1. Spacious 2BR in Manhattan
💰 Price: $3,500/month
📍 Location: Upper East Side, New York
🛏️ Bedrooms: 2
🚿 Bathrooms: 1
📐 Area: 900 sq ft
🏠 Type: apartment
🔗 Link: https://...
2. Modern 2-Bedroom Apartment
💰 Price: $3,200/month
📍 Location: Brooklyn Heights, New York
🛏️ Bedrooms: 2
🚿 Bathrooms: 2
📐 Area: 1100 sq ft
🏠 Type: apartment
🔗 Link: https://...
- Zillow.com
- Apartments.com
- Rent.com
- Realtor.com
- Trulia.com
- Redfin.com
- Rentals.com
- PadMapper.com
- HotPads.com
- ForRent.com
- Get your free API keys: Hyperbrowser and SerpAPI
- Clone and setup this repository (takes 2 minutes)
- Run the bot and find your perfect property!
- SerpAPI: Check your plan limits on the SerpAPI dashboard
- Hyperbrowser: Check your usage on the Hyperbrowser dashboard
No listings found?
- Try different search criteria
- Check if your target location is a valid US city/state
- Verify your API keys are correctly set in the
.envfile
API errors?
- Ensure your API keys are valid and have sufficient credits
- Check your internet connection
- Verify the
.envfile is in the correct location
SERPAPI_KEY error?
- Make sure you've added
SERPAPI_KEY=your_actual_api_keyto your.envfile - Get your free API key from SerpAPI
The application uses:
- TypeScript for type safety
- Zod for data validation and schema definition
- SerpAPI for web search functionality
- Hyperbrowser SDK for intelligent data extraction
- Inquirer for interactive command-line prompts
MIT License