🏡 AI Real Estate Agent

🚀 AI Real Estate Agent is an Apify Actor that searches for real estate listings on Zillow based on user queries.
It extracts ZIP codes using an LLM (GPT-3.5-Turbo) and fetches property listings using the Zillow Scraper.

---

📌 Features

✔ Natural Language Search – Users can input queries like:
"Find a 2-bedroom apartment in San Francisco, CA, with a rent between $2000 and $4000."
✔ LLM-Powered ZIP Code Extraction – Extracts ZIP codes directly from the city/state.
✔ Zillow Scraper Integration – Fetches listings for sale or rent.
✔ Custom Search Filters – Supports price range, number of bedrooms, and amenities.
✔ Structured Output – Provides a JSON response with property details.

---

🚀 How It Works

1️⃣ User Input: Natural language real estate query.
2️⃣ Extract Search Parameters: LLM extracts city, state, price, and amenities.
3️⃣ Get ZIP Codes: LLM finds relevant ZIP codes for the location.
4️⃣ Scrape Zillow Listings: Apify Zillow scraper retrieves matching properties.
5️⃣ Return Structured Results: JSON response with listings.

---

📦 Installation & Setup

1️⃣ Clone the Repository

git clone https://github.com/yourusername/ai-realestateagent.git
cd ai-realestateagent

2️⃣ Create a Virtual Environment (Optional)

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

3️⃣ Install Dependencies

$pip install -r requirements.txt

4️⃣ Set API Keys

Create a .env file and add your API keys:

OPENAI_API_KEY=your-openai-key

---

🎯 How to Run Locally

$apify run --input-file=input.json

📜 Example input.json

{
    "query": "Find a 2-bedroom apartment in San Francisco, CA, with a rent between $2000 and $4000."
}

---

🛠 Project Structure

ai-realestateagent/ │── src/ │ ├── main.py # Apify Actor entry point │ ├── tools.py # LLM-powered search + Zillow scraper integration │ ├── models.py # Pydantic models for structured responses │── .venv/ # Virtual environment (optional) │── requirements.txt # Python dependencies │── README.md # Project documentation │── input.json # Example input format │── .env # API keys (gitignore this file)

Sample Report

🏡 AI Real Estate Search Report

📍 Search Details

• Query: Searching for a 2-bedroom apartment in San Francisco, CA, with a monthly rent between $2000 and $4000, and preferably featuring amenities such as parking and a gym.

🔍 Results

🏠 NEMA

• 📍 Address: 8 10th St, San Francisco, CA
• 💰 Price: N/A
• 🛏 Bedrooms: N/A
• 🛁 Bathrooms: N/A
• 📏 Area: N/A sq ft
• 📅 Days on Zillow: N/A
• 🖼 Image:

---

🏠 33 8th at Trinity Place

• 📍 Address: 33 8th St, San Francisco, CA
• 💰 Price: N/A
• 🛏 Bedrooms: N/A
• 🛁 Bathrooms: N/A
• 📏 Area: N/A sq ft
• 📅 Days on Zillow: N/A
• 🖼 Image:

---

🏠 1190 Mission at Trinity Place

• 📍 Address: 1190 Mission St, San Francisco, CA
• 💰 Price: N/A
• 🛏 Bedrooms: N/A
• 🛁 Bathrooms: N/A
• 📏 Area: N/A sq ft
• 📅 Days on Zillow: N/A
• 🖼 Image:

---

🏠 AVA 55 Ninth

• 📍 Address: 55 9th St, San Francisco, CA
• 💰 Price: N/A
• 🛏 Bedrooms: N/A
• 🛁 Bathrooms: N/A
• 📏 Area: N/A sq ft
• 📅 Days on Zillow: N/A
• 🖼 Image:

---

🏠 1335 Folsom

• 📍 Address: 1335 Folsom St, San Francisco, CA
• 💰 Price: N/A
• 🛏 Bedrooms: N/A
• 🛁 Bathrooms: N/A
• 📏 Area: N/A sq ft
• 📅 Days on Zillow: N/A
• 🖼 Image:

---

---

📌 This report was generated automatically. Please verify details before making decisions.